home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 34 / Amiga Format CD34 (1998-11-20)(Future Publishing)(GB)[!][Christmas issue].iso / -websites- / sasg / dfa / doc / dfa26ase.lha / english / dfa.doc
Encoding:
Text File  |  1986-09-04  |  213.4 KB  |  6,767 lines
  1.  
  2.  
  3.                             DFA - DFAddress
  4.  
  5.                    The address utility for the AMIGA
  6.  
  7.                 (C) Copyright 1992-1995 Dirk Federlein
  8.  
  9.                     *** DFA is an SASG product ***
  10.  
  11.                              - Shareware -
  12.  
  13. This manual describes the installation and the usage of *DFA* version
  14. 2.6. If you use a localized Workbench (Workbench V2.1 and better) and
  15. have set it to a language other than English, please notice that I'll
  16. refer to the English program texts in this documentation!
  17.  
  18. Welcome!
  19. ********
  20.  
  21. Welcome to the documentation of *DFA*!  Please, do *not* stop here, but
  22. continue reading - it will be to your advantage!
  23.  
  24. Only by reading this manual carefully, can learn everything about the
  25. many different features of *DFA*! Some of your questions - if not all
  26. of them - which you might have at this time, will be answered here.
  27.  
  28. Please remember that I put a lot of time and effort (`blood, sweat and
  29. tears') into this manual -- please show your acknowledgement by reading
  30. this documentation (of course, you may feel free to register)!
  31.  
  32.           *Dirk Federlein*
  33.  
  34. Features
  35. ********
  36.  
  37. *DFA* supplies many outstanding features, some of them I'd like to
  38. mention here:
  39.  
  40.    * OS2.0 "Look and Feel"
  41.  
  42.         - Commodity support, i.e. *DFA* can be reached by hotkey or the
  43.           Exchange utility of the Workbench
  44.  
  45.         - The *DFA-Editor* main window is an application window
  46.  
  47.         - Application icon and application menu (can be toggled)
  48.  
  49.         - It is possible to use *DFA* as default tool
  50.  
  51.    * Starting with OS2.1 locale is supported
  52.  
  53.    * OS3.0 is supported, if available
  54.  
  55.    * Comfortable and nice user interface
  56.         - MagicWB icons for all programs and drawers of the distribution
  57.  
  58.         - Button row with MagicWB images to access the most important
  59.           functions
  60.  
  61.         - All windows of *DFA* are font sensitive
  62.  
  63.         - The *DFA-Editor* main window is font sensitive and *resizable*
  64.  
  65.         - All operations in *DFA* are accessable via keyboard
  66.  
  67.    * Extensive opportunities to customize *DFA*
  68.         - The format of the address listview and of display part in the
  69.           main window of the *DFA-Editor* can be changed
  70.  
  71.         - Addresses can be sorted by any (text) field of the address
  72.  
  73.         - The fonts for the *DFA-Editor* and the *DFA-Preferences* can
  74.           be changed
  75.  
  76.         - Custom screens can be used
  77.  
  78.    * Powerful AREXX interface for best flexibility
  79.  
  80.    * Carefully programmed application for optimal efficiency
  81.         - The program has been split into the editor, server and
  82.           preferences parts; by this the available memory is optimally
  83.           used and *DFA* often needs even less memory than in version
  84.           1.2x
  85.  
  86.         - Program parts used by more than one part of *DFA* have been
  87.           exported into a shared library, the `dfa.library'
  88.  
  89.         - The internal memory management was rewritten from scratch with
  90.           the consequence that the addresses now use much less RAM than
  91.           in version 1.2x
  92.  
  93.         - The usage of memory pools decreases memory fragmentation
  94.  
  95.         - Highly optimized  load and save routines.
  96.  
  97.    * Outstanding features
  98.         - Support of external files
  99.  
  100.         - Powerful dial function
  101.  
  102.         - The addresses can be separated into groups
  103.  
  104.         - Network support
  105.  
  106. Installation
  107. ************
  108.  
  109. I strongly recommend use of the supplied install program to install
  110. *DFA*. It extracts the needed files from their archives and copies them
  111. to the correct places on your harddisk. It sets all needed tooltypes as
  112. well.
  113.  
  114. After the installation procedure has been completed, there exist the
  115. following files, or according to your installation, at least some of
  116. them, on your harddisk:
  117.  
  118.    * *`DFA', `DFA.info'*
  119.  
  120.      The *DFA-Server* program; it supplies the AREXX-Port and manages
  121.      the Application icon. Putting it into the `WBStartup' drawer is a
  122.      good idea.
  123.  
  124.    * *`DFAEditor', `DFAEditor.info'*
  125.  
  126.      The graphical user interface of *DFA*. If you want to start this
  127.      program from the Shell, please copy it into a drawer in your
  128.      search path, otherwise in any directory you like, e.g. `DFA:c',
  129.      which is the default.
  130.  
  131.    * *`DFAPrefs', `DFAPrefs.info'*
  132.  
  133.      The preferences program for *DFA*. All settings can be done from
  134.      within this program. A good place for it is the `SYS:Prefs' or the
  135.      `DFA:Prefs' directory.
  136.  
  137.    * *`dfa.library'*
  138.  
  139.      Must be in `libs:' or in `DFA:libs'. This library is needed by all
  140.      other parts of *DFA*, i.e. the *DFAServer*, the *DFAEditor* and
  141.      the *DFAPrefs* program.
  142.  
  143.    * *`Registration', `Registration.info'*
  144.  
  145.      This is the new registration program of the *SASG*. This program
  146.      makes it possible to register or update in a very comfortable and
  147.      fast way. Furthermore it contains detailed information about the
  148.      *SASG* and the *advantages* that *you* may take out of it.
  149.  
  150.    * *`DFA.guide'*
  151.  
  152.      The AMIGAGUIDE documentation of *DFA*. To read the file you need
  153.      e.g. the `AmigaGuide' or the `Multiview' program.
  154.  
  155.    * *`DFA.dvi'*
  156.  
  157.      The manual in the `DVI' format. To look at it or print it you need
  158.      TeX (e.g. PasTeX (C) Georg Heßmann).
  159.  
  160.    * *`DFAEditor.guide'*
  161.  
  162.      The online help for the *DFA-Editor*; it can be found  in
  163.      `Help:<language>' or in the drawer you selected during the
  164.      installing procedure.
  165.  
  166.    * *`DFAPrefs.guide'*
  167.  
  168.      The online help for the *DFA-Preferences* program; it can be found
  169.      in `Help:<language>' or in the drawer you selected during the
  170.      installing procedure.
  171.  
  172.    * *`dfa.key'*
  173.  
  174.      If you've got a registered version of *DFA*, you can find the
  175.      so-called keyfile `dfa.key' in the `s' drawer of the distribution.
  176.  
  177.      To give *DFA* the chance to find the keyfile you either have to
  178.      copy it to the `s:' drawer of your boot partition (default) or, if
  179.      you prefer another directory for your keyfile, you will have to set
  180.      the environment variable `KEYPATH' to this *drawer*.
  181.  
  182.  
  183.           Example:
  184.           
  185.           setenv KEYPATH ENV:DFA
  186.  
  187.      Usually the install program has already done this for you.
  188.  
  189.    * *`AddressFiles/Default.dfa'*
  190.  
  191.      The default address file. It contains the address of the program
  192.      author.
  193.  
  194.    * *`rexx/#?.ced'*
  195.  
  196.      AREXX scripts for the CED ((C) 1987-1993 CYGNUSSOFT SOFTWARE)
  197.      working together with *DFA*. The explanation of each AREXX script
  198.      can be found in the scripts.
  199.  
  200.    * *`rexx/#?.dfa'*
  201.  
  202.      AREXX scripts that can be started directly out of the *DFA-Editor*
  203.      (via the function keys).
  204.  
  205.    * *`rexx/#?.rexx'*
  206.  
  207.      AREXX scripts that can be be started out of the shell (using the
  208.      `rx' command.
  209.  
  210.    * *`locale/Catalogs/<language>/#?.catalog'*
  211.  
  212.      In each `language' directory (e.g. `deutsch' you can find the
  213.      catalog files that are needed for the locale support (Workbench
  214.      2.1 and better needed). Usually the installer script has already
  215.      copied the needed files to the correct drawers.
  216.  
  217. Quick Start
  218. ***********
  219.  
  220. After you have installed *DFA* (see Installation, for more
  221. information), the default settings are used. These settings already
  222. allow you to use *DFA* and take a lot of advantage out of it. Please
  223. notice that the *huge* amount of settings, which can be tuned in the
  224. *DFA-Preferences* program, can only be saved in the *registered*
  225. version (see DFAPrefs and Registration for details)!
  226.  
  227. If you copied the *DFA-Server* (filename `DFA') into the `WBStartup'
  228. drawer, as it is recommended by the install program, *DFA* will be
  229. started each time the computer starts up; futhermore, an application
  230. icon for *DFA* is supplied on the Workbench screen.
  231.  
  232. This behaviour of *DFA* can be changed as described in ServerTooltypes
  233. and DFAPrefs.
  234.  
  235. As *DFA* tries to follow the "User Interface Style Guide" as closely as
  236. possible, it should be no problem (at least for advanced users) to
  237. figure out all the functions of *DFA* according to "trial and error".
  238. If you don't want any bad (?) surprises, just continue reading...
  239.  
  240. The concept of DFA
  241. ******************
  242.  
  243. Beginning with *DFA* version 2.0, it is no longer a single program, but
  244. consists of several parts: The *DFA-Server* (see DFAServer); the
  245. *DFA-Editor* (see DFAEditor) and the *DFA-Preferences* program (see
  246. DFAPrefs).
  247.  
  248. Certain functions that are used by more than one of these programs have
  249. been exported into a socalled "shared library", the `dfa.library'.
  250.  
  251. By doing so, it is possible now that *DFA* often uses less RAM than in
  252. former versions of *DFA*, even though it contains many enhancements! If
  253. *DFA* would still have been one single program, it would have been a
  254. size of about 300 KB and nearly noone would have copied it into the
  255. `WBStartup' drawer.
  256.  
  257. In spite of splitting the program into several parts, I tried to keep
  258. the known handling of *DFA*: one should think he works with one single
  259. program. To do so, the *DFA-Server* calls the *DFA-Editor* after the
  260. user hits the hotkey; the *DFA-Preferences* program on the other hand
  261. can be reached directly out of the *DFA-Editor* by selecting the
  262. corresponding menu item.
  263.  
  264. This new concept will be useful for people that start *DFA* on demand
  265. only and therefore don't need the AREXX and the Commodity part of
  266. *DFA*; these people may start the *DFA-Editor* directly (from the
  267. Workbench or Shell) and save the memory the *DFA-Server* would have
  268. taken (about 40 KB).
  269.  
  270. Usage of DFA
  271. ************
  272.  
  273. You can control *DFA* *completely* by mouse or by keyboard.
  274.  
  275. Some notes on the usage of the keyboard:
  276.  
  277.    * *Button Gadgets*
  278.  
  279.      All Gadgets have a corresponding text.  In this text you'll find
  280.      one character *underlined*.  This character is the "shortcut" to
  281.      the gadget.  To use this shortcut, just push the corresponding
  282.      key.  You don't have to push any qualifier like `CONTROL' or
  283.      `ALT'.  For simple buttons it doesn't matter if you push the
  284.      "normal" or the capital letter.  For other gadgets it can make a
  285.      difference (see below for details).
  286.  
  287.    * *Listviews*
  288.  
  289.      Listviews are used in the *DFA-Editor* as well as in the
  290.      *DFA-Preferences* program. There are two different types of
  291.      listviews: Listviews in which you can select entries (raised
  292.      border), e.g. the address listview in the *DFA-Editor* main window,
  293.      and listviews that only display information (recessed border), e.g.
  294.      the listview in the *DFA-Editor* full window.
  295.  
  296.      If not mentioned otherwise, all listviews can be used as follows:
  297.  
  298.      *Input listview:*
  299.  
  300.  
  301.             Shortcut         The next entry becomes the active one,
  302.                              the list scrolls accordingly.
  303.  
  304.           Shift Shortcut     The previous entry becomes the active one,
  305.                              the list scrolls accordingly.
  306.  
  307.      *Read only listview:*
  308.  
  309.  
  310.             Shortcut         The list scrolls *up*.
  311.  
  312.           Shift Shortcut     The list scrolls *down*.
  313.  
  314.      Sometimes the listviews can be controlled by the cursor keys, or
  315.      it is possible to scroll page by page. If this is the case, the
  316.      enhanced usage of that particular listview is described seperately
  317.      on that place.
  318.  
  319.    * *Cycle Gadgets*
  320.  
  321.      In front of a cycle gadget there is short text, which describes the
  322.      function of the gadget. Again there is one character underlined.
  323.      However, here it does matter if you use the capital letter or not.
  324.      The "normal" letter cycles foreward, the capital letter backward.
  325.  
  326.    * *Radio Buttons*
  327.  
  328.      Only one of the buttons that belong together can be activated at
  329.      once.  You can select an entry by pushing the proper shortcut.
  330.      The case of the shortcut is not important.
  331.  
  332.    * *Check Boxes*
  333.  
  334.      A check box can be selected (shown by a tick) or deselected
  335.      ("blank"). You can switch the current state by pushing the
  336.      corresponding hotkey.
  337.  
  338.    * *String Gadgets*
  339.  
  340.      The string gadgets have the same functions as the "original" string
  341.      gadgets.  However, I added some features which should make them
  342.      easier to use:
  343.  
  344.         - Hit `RETURN' to end the input to the current gadget and go to
  345.           the next string or integer gadget. You may use the `ENTER' key
  346.           alternatively.
  347.  
  348.         - Hit `SHIFT' `RETURN' to end the input to the current gadget
  349.           and go to the *previous* gadget.
  350.  
  351.         - Hitting `CURSOR UP' or `CURSOR DOWN' brings the cursor to the
  352.           previous or next string gadget respectively.
  353.  
  354.         - Hit `ESCAPE' to cancel the input into the current string
  355.           gadget.
  356.  
  357.         - If the cursor stands within a string gadget, the shortcuts can
  358.           be reached by hitting `RIGHT AMIGA'-`<letter>' and `SHIFT'.
  359.           If you don't hit `SHIFT' additionally, the keyboard shortcut
  360.           is used either by the internal string gadget edit features
  361.           (like `RIGHT AMIGA X' or `RIGHT AMIGA Q') or by additional
  362.           tools like `NewList'.
  363.  
  364.      You activate a string gadget by pushing the according shortcut.
  365.      Usually there is no difference if you hit the upper case or the
  366.      lower case character, as long as there is no button gadget behind
  367.      the string gadget. This button gadget that contains a small symbol
  368.      instead of text, activates a requester, which allows a more
  369.      comfortable input in the string gadget in front of it. If there is
  370.      such a button, you activate the string gadget with the lower case
  371.      key and the button gadget behind the string gadget with the upper
  372.      case key.
  373.  
  374.    * *Text Gadgets*
  375.  
  376.      Usually text gadgets don't have a shortcut, as they only display
  377.      text, but don't allow any input. Some text gadgets, however, have
  378.      a small button gadget behind them (cf. *DFA-Preferences*:
  379.      Font-Preferences) After you have hit this gadget, a requester pops
  380.      up and you may select an entry which is displayed in the text
  381.      gadget as soon as you've completed the requester. Therefore, the
  382.      gadget shortcut doesn't refer to the text gadget itself, but to
  383.      the button gadget behind it.
  384.  
  385.    * *Online Help*
  386.  
  387.      Beginning with *DFA* version 1.2, it supports an *Online Help*
  388.      feature.  To invoke it, just hit the `Help' key and the help
  389.      window pops up.  Please remember that the `GUIDEFILE' tooltype of
  390.      the *DFA-Editor* and the *DFA-Preferences* program have to be set
  391.      correctly.  The installer program usually has already done this
  392.      for you.
  393.  
  394. The DFA-Server program
  395. **********************
  396.  
  397. The *DFA-Server* (filename: `DFA') supplies the commodity features
  398. (hotkey, access by the `Exchange' program) and contains the complete
  399. AREXX interface; furthermore it manages the application icon.
  400.  
  401. *Please notice:*
  402.  
  403. If you want to use any AREXX functions out of the *DFA-Editor*, you
  404. have to make sure that the *DFA-Server* is running.
  405.  
  406. Tooltypes
  407. =========
  408.  
  409. If you click on the icon of the *DFA-Server* program once and activate
  410. the information program from the Workbench menu, you may change the
  411. following tooltypes:
  412.  
  413.    * *`ADDRESSFILE'*
  414.  
  415.      If you use this tooltype, you can change the name of the address
  416.      file that will be loaded by *DFA* during startup (e.g.
  417.      `ADDRESSFILE=MyAddresses.dfa').  Please notice that, in this case,
  418.      the file you set in the *DFA-Preferences* program is not used.
  419.  
  420.    * *`CX_POPKEY'*
  421.  
  422.      The preset hotkey is `LCOMMAND F5', i.e. you can pop up the
  423.      *DFA-Editor* by pushing `Left Amiga F5' (cf. `CX_POPUP').
  424.  
  425.      You can change this hotkey using the following keywords:
  426.  
  427.  
  428.           LSHIFT      left shift key
  429.           RSHIFT      right shift key
  430.           CAPSLOCK    caps lock key
  431.           CONTROL     control key
  432.           LALT        left alt key
  433.           RALT        right alt key
  434.           LCOMMAND    left AMIGA key
  435.           RCOMMAND    right AMIGA key
  436.           NUMERICPAD  numeric pad
  437.           MIDBUTTON   middle mouse button
  438.           RBUTTON     right mouse button
  439.           LEFTBUTTON  left mouse button
  440.           F1-F10      function keys 1 to 10
  441.           UP          cursor up
  442.           DOWN        cursor down
  443.           LEFT        cursor left
  444.           RIGHT       cursor right
  445.           HELP        help key
  446.           DEL         del key
  447.           RETURN      return key
  448.           ENTER       enter key on the numeric pad; notice that you have
  449.                       to set `NUMERICPAD' as well!
  450.           BACKSPACE   backspace key
  451.           ESC         escape key
  452.           SPACE       space key
  453.           COMMA       comma key
  454.           UPSTROKE    upstroke key
  455.           A..Z, a..z  "usual" keys
  456.           0..9, etc.
  457.  
  458.      You can "mix" these keys, for example:
  459.  
  460.         - `LSHIFT CONTROL F1'
  461.  
  462.         - `LALT CONTROL D'
  463.  
  464.         - `CONTROL NUMERICPAD ENTER'
  465.  
  466.         - `RCOMMAND RSHIFT A'
  467.  
  468.    * *`CX_POPUP'*
  469.  
  470.      If you set `CX_POPUP=YES', you make the *DFA-Server* calling the
  471.      *DFA-Editor* immediately after startup.  Set `CX_POPUP=NO' to keep
  472.      *DFA* "quiet" until you pop up the *DFA-Editor* by hitting the
  473.      hotkey, or clicking on the application icon, or by starting the
  474.      *DFA-Editor* directly from the Workbench or the Shell.
  475.  
  476.    * *`CX_PRIORITY'*
  477.  
  478.      With this Tool Type you can change the Priority of the *DFA*
  479.      commodity part. The default setting of `CX_Priority=0' usually
  480.      doesn't need to be changed. For more information look up your
  481.      manual to the *AMIGA-OS*.
  482.  
  483.    * *`DFAEDITOR'*
  484.  
  485.      This tooltype contains the filename (incl. the full path) that is
  486.      used by the *DFA-Server* to call the *DFA-Editor*. The install
  487.      program has usually set this tooltype according to your wishes,
  488.      you only have to change anything if you copied the *DFA-Editor*
  489.      manually to another place on your harddisk.
  490.  
  491.    * *`DONOTWAIT'*
  492.  
  493.      This is a system Tool Type which forces the Workbench to not wait
  494.      for *DFA* to finish loading.  You should *not* remove this tool
  495.      type.
  496.  
  497.    * *`PORTNAME'*
  498.  
  499.      *DFA* uses `DFA' for the portname.  If there is another program
  500.      with the same portname, *DFA* attaches numbers (`DFA.1', `DFA.2',
  501.      etc.) until a definite name is found.  However, if you want your
  502.      "own" portname, you can set it using the tool type `PORTNAME'
  503.      (e.g.  `PORTNAME=OtherDFAPortname').  Please remember that you
  504.      have to adapt all example AREXX scripts, if you change the
  505.      portname!
  506.  
  507. CLI Parameters
  508. ==============
  509.  
  510. If you start *DFA* from Workbench, the tooltypes described above will
  511. be used. When you start *DFA* from Shell, these tooltypes are used as
  512. well, as long as the corresponding `.info'-File is present. You can
  513. give the following parameters to *DFA* that overwrite the previous
  514. settings (within the .info file). The possible arguments are described
  515. below:
  516.  
  517. `ADDRESSFILE/K', `CX_POPKEY/K', `CX_PRIORITY/N', `CX_POPUP/K',
  518. `PORTNAME/K', `DFAEDITOR/K'
  519.  
  520. This means you may...
  521.  
  522.    ... set the hotkey to `Left Amiga F1' by `DFA CX_POPUP="LCOMMAND F1"'
  523.  
  524.    ... set the AREXX port to `MyArexxPort' by `DFA PORTNAME=MyArexxPort'
  525.  
  526.    ... load the alternate address file `MyAddresses.dfa' by `DFA
  527.      ADDRESSFILE=MyAddresses.dfa'
  528.  
  529. Commodity
  530. =========
  531.  
  532. By pushing the hotkey (see ServerTooltypes), you may invoke the
  533. *DFA-Editor*. You'll get the same effect, if you start the `Exchange'
  534. program of the Workbench and select `Show Interface'.
  535.  
  536. Using the `Exchange' program, you can stop *DFA* (hit `Remove'), or to
  537. make it inactive (hit `Inactive'), or active respectively.
  538.  
  539. Application-Icon
  540. ================
  541.  
  542. The application icon supplies two functions:
  543.  
  544.    * A double click on it activates the *DFA-Editor*.
  545.  
  546.    * If you let the icon of an address file "fall" on the application
  547.      icon, the *DFA-Editor* is started and the according address file is
  548.      loaded.
  549.  
  550. Arexx
  551. =====
  552.  
  553. *Please notice:*
  554.  
  555. To use the AREXX functions of the *DFA-Editor*, the *DFA-Server* has to
  556. run simutaneously.
  557.  
  558. Important -- new features since version 1.2x
  559. --------------------------------------------
  560.  
  561. The AREXX interface has been rewritten from scratch for *DFA* 2.0. Some
  562. commands have been added...
  563.    * ATTEMPTLOCK
  564.  
  565.    * CHANGEGROUPS
  566.  
  567.    * EDITTEMPLATE (v2.5)
  568.  
  569.    * FREELOCK
  570.  
  571.    * GETPREFS (v2.5)
  572.  
  573.    * GETTEMPLATE (v2.5)
  574.  
  575.    * LOADPREFS (v2.5)
  576.  
  577.    * NEWFILE
  578.  
  579.    * SAVEPREFS (v2.5)
  580.  
  581.    * SETPREFS (v2.5)
  582.  
  583. ... some old commands have been changed or improved regarding their
  584. syntax:
  585.  
  586.    * APPEND
  587.  
  588.    * CHANGEGROUPS (v2.5)
  589.  
  590.    * EDIT (v2.0, v2.2)
  591.  
  592.    * KILL
  593.  
  594.    * LOAD
  595.  
  596.    * NEW
  597.  
  598.    * SAVEAS
  599.  
  600.    * SEARCH (v2.5)
  601.  
  602. Most of all, however, I've changed the order of the fields within an
  603. address item, which is returned by several commands like `FIRST',
  604. `NEXT', `GETCURRENT', etc.
  605.  
  606. The reason for doing so is that I thought it would be a good idea to
  607. have the same order of the fields in the AREXX interface as in the
  608. *DFA-Editor* edit window, as this makes it much easier to remember
  609. which meaning the different numbers of an address field have (cf.
  610. ArexxReturnAddress).
  611.  
  612. Basics
  613. ------
  614.  
  615. *DFA* (i.e. the *DFA-Server*) usually accepts AREXX commands at any
  616. time, even if the *DFA-Editor* and/or the *DFA-Preferences* program is
  617. running at the same time.  It is possible, however, that the execution
  618. of an AREXX command will be delayed if someone for example is just
  619. editing an address within the `Edit' window of the *DFA-Editor*. The
  620. reason for this safety protocol can be explained easily: As the
  621. addresses are kept in memory only once, all *DFA* related programs have
  622. access to the same address list. By the protocol described above, I
  623. want to make sure that no part of the *DFA* package tries to use
  624. addresses that another part of *DFA* has already deleted (this would
  625. sooner or later cause the machine to crash).
  626.  
  627. The basics of the AREXX programming language can be found in the AREXX
  628. manual that comes along with *AMIGA-OS 2.0* or better or in the "AREXX
  629. User's Reference Manual"(1).
  630.  
  631. The AREXX port that has to be used to address *DFA* is `DFA', as long
  632. as you did not change this name by the tooltype `PORTNAME', as
  633. described in ServerTooltypes.  This should only be done, if you have
  634. another program running that uses the portname `DFA', as well, and you
  635. don't want to use *DFA*'s feature to choose a clear portname.
  636.  
  637. A further remark on the `Load', `Append', and `Save as' commands:
  638.  
  639. If you give a filename, you should always use the complete pathname, as
  640. otherwise it is very likely that the file can't be found or is written
  641. to a place you don't expect. Refering to the home directory of *DFA*
  642. doesn't make much sense, as *DFA* is often placed in another drawer
  643. than the address files and, furthermore, as *DFA* remembers the
  644. recently loaded filename and uses it for loading and saving.
  645.  
  646. Beyond the item `Syntax', the possible parameters are listed.  The
  647. description of the parameters follows the known style given by
  648. Commodore, here is its meaning:
  649.  
  650. */S - Switch*
  651.      This is considered a boolean variable.  If this option is present,
  652.      the corresponding option is enabled, otherwise it keeps disabled.
  653.  
  654. */K - Keyword.*
  655.      This parameter must be given in the format `keyword=<setting>';
  656.      e.g. the `PRINT' command can get `FORM/K' either as `FORM=ALL' or
  657.      `FORM=SELECTED' or `FORM=ACTIVE'.  The equal sign `=' may be left
  658.      out.
  659.  
  660. */N - Number.*
  661.      This means the parameter is considered a decimal integer,
  662.  
  663. */T - Toggle.*
  664.      This is similar to the switch (/S) modifier, but one of the
  665.      keywords `yes', `on', `no' or `off' is expected (not case
  666.      sensitive). According to the keyword you provide, the option is
  667.      switched on or off respectively.
  668.  
  669.      Please notice that you may *not* use the equal sign (`=') between
  670.      the parameter and the modifier.
  671.  
  672.      The following examples may give you an idea, how this switch can be
  673.      used:
  674.  
  675.      Examples:
  676.  
  677.               gui input off output on
  678.           
  679.               gui input yes output ON
  680.           
  681.               gui input NO output off
  682.  
  683.      *Important:*
  684.  
  685.      Starting with version 2.2 of DFA the behaviour of this /T switch
  686.      changed a bit, so please adopt your Arexx scripts accordingly.
  687.  
  688. */A - Always.*
  689.      This modifier means that this option is required. It must appear in
  690.      the command line.
  691.  
  692. The exact syntax for every AREXX command can be found below, see
  693. ArexxCommands, for details.
  694.  
  695. *Important:*
  696.  
  697. The AREXX interface of *DFA* gives you a powerful instrument to manage
  698. the stored addresses. A wider range of functionality, however,
  699. implements more ways of loosing your data! This could happen not only
  700. by a malfunction of `DFA', but also by an improper used function or
  701. parameter.  Therefore, I encourage you to make regular copies of your
  702. databases to keep the potential damage as small as possible.
  703.  
  704.  
  705. ---------- Footnotes ----------
  706.  
  707. (1)  AREXX User's Reference Manual, William S. Hawes, P.O. Box 308,
  708. Maynard, MA 01754
  709.  
  710. Format of the Address Field
  711. ---------------------------
  712.  
  713. If `ADDRESS/M' is listed in the return code section, this means that
  714. the corresponding command returns the wanted address if it has been
  715. executed successfully. The address can be found either in the variable
  716. given together with the AREXX keyword `STEM' or `VAR' or in the default
  717. variable `RESULTS'.
  718.  
  719. Example:
  720.          /* Outputs the first address */
  721.      
  722.          ADDRESS "DFA"
  723.          OPTIONS RESULTS
  724.      
  725.          /* Please notice the full stop behind 'TEST' ! */
  726.      
  727.          FIRST STEM TEST.
  728.          SAY TEST.ADDRESS.2
  729.          EXIT
  730.  
  731. This short example outputs the name of the first entry of the address
  732. list.
  733.  
  734.  
  735. The `STEM' keyword returns the address in the form of a list, i.e. the
  736. address items appear in `TEST.ADDRESS.0' through `TEST.ADDRESS.25'.  In
  737. `TEST.ADDRESS.COUNT' you can find the number of entries of the address
  738. array. The `VAR' keyword lets *DFA* return the desired address as well,
  739. but the whole address is stored in one single variable, separated by
  740. spaces. Please consult your AREXX manual for further details.
  741.  
  742. The address fields correspond to the following "numbers":
  743.  
  744. *0*
  745.      Salutation
  746.  
  747. *1*
  748.      First
  749.  
  750. *2*
  751.      Name
  752.  
  753. *3*
  754.      Co
  755.  
  756. *4*
  757.      Street
  758.  
  759. *5*
  760.      Zip
  761.  
  762. *6*
  763.      City
  764.  
  765. *7*
  766.      State
  767.  
  768. *8*
  769.      Country
  770.  
  771. *9*
  772.      Birthday
  773.  
  774. *10*
  775.      Phone
  776.  
  777. *11*
  778.      Fax
  779.  
  780. *12*
  781.      Email1
  782.  
  783. *13*
  784.      Email2
  785.  
  786. *14*
  787.      Email3
  788.  
  789. *15*
  790.      Comment
  791.  
  792. *16*
  793.      Group1
  794.  
  795. *17*
  796.      Group2
  797.  
  798. *18*
  799.      Group3
  800.  
  801. *19*
  802.      Group4
  803.  
  804. *20*
  805.      Group5
  806.  
  807. *21*
  808.      Group6
  809.  
  810. *22*
  811.      Group7
  812.  
  813. *23*
  814.      Group8
  815.  
  816. *24*
  817.      Selected
  818.  
  819. *25*
  820.      External
  821.  
  822. Arexx commands
  823. --------------
  824.  
  825. The ABOUT Command
  826. .................
  827.  
  828. `Syntax:'
  829.      ABOUT
  830.  
  831. `Function:'
  832.      The `About' window of *DFA* is opened
  833.  
  834. The APPEND Command
  835. ..................
  836.  
  837. `Syntax:'
  838.      APPEND [FILENAME] <string> [FORCE] [PROMPT]
  839.  
  840. `Argument template:'
  841.      FILENAME, FORCE/S, PROMPT/S
  842.  
  843. `Function:'
  844.      New addresses are appended to the existing address database.  If
  845.      the existing addresses have been changed, the new addresses are
  846.      not appended, as long as you don't supply the keyword `FORCE'
  847.      additionally. It is possible to use the `PROMPT' parameter, which
  848.      will supply a file requester to input the desired filename of the
  849.      address database to append.
  850.  
  851. `Argument description:'
  852.         * FILENAME <string>
  853.  
  854.           The filename of the address file to be appended.
  855.  
  856.         * FORCE
  857.  
  858.           Forces appending the address file.
  859.  
  860.         * PROMPT
  861.  
  862.           Opens a file requester that allows the selection of the
  863.           address file to be appended.
  864.  
  865. `Results:'
  866.      The following error codes can be returned in `RC2':
  867.  
  868.         * RXERR_NOFILENAME
  869.  
  870.         * RXERR_APPENDFAILED
  871.  
  872.         * RXERR_ENVCHANGED
  873.  
  874.         * RXERR_NONETWORKAPPEND
  875.  
  876.         * RXERR_MODIFIED
  877.  
  878. The ATTEMPTLOCK Command
  879. .......................
  880.  
  881. `Syntax:'
  882.      ATTEMPTLOCK [<retries>] [<delay>]
  883.  
  884. `Argument template:'
  885.      RETRIES/N, DELAY/N
  886.  
  887. `Function:'
  888.      If you are in network mode (see PrefsNetworking), you have to get
  889.      write access to the address file, before you may modify anything.
  890.      To do so you have to use the `ATTEMPTLOCK' command. If someone
  891.      else in the LAN keeps the write access to the desired address
  892.      file, this commands returns an error code in `RC' and `RC2' (see
  893.      FREELOCK).
  894.  
  895. `Argument description:'
  896.         * RETRIES
  897.  
  898.           Maximal number of retries, if the attempt to get write access
  899.           did not succeed at once.
  900.  
  901.         * DELAY
  902.  
  903.           Number of seconds that shall pass between two retries.
  904.  
  905. `Results:'
  906.      The following error codes can be returned in `RC2':
  907.  
  908.         * RXERR_ENVCHANGED
  909.  
  910. The CHANGEGROUPS Command
  911. ........................
  912.  
  913. `Syntax:'
  914.      CHANGEGROUPS [<group2>] [<group1>] [<group3>] [<group4>]
  915.      [<group5>] [<group6>] [<group7>] [<group8>] [ALL]
  916.  
  917. `Argument template:'
  918.      GROUP2/T, GROUP1/T, GROUP3/T, GROUP4/T, GROUP5/T, GROUP6/T,
  919.      GROUP7/T, GROUP8/T, ALL/S
  920.  
  921. `Function:'
  922.      Changes the active group selection. Commands like `PRINT' or
  923.      `SEARCH' apply only to the currently active groups. To reach all
  924.      addresses in all groups you have to activate them using this
  925.      command before.
  926.  
  927.      Please notice that I have changed the syntax of this command for
  928.      version 2.5. Instead of the `/S' switch I implemented the `/T'
  929.      toggle switch, which is more flexible.
  930.  
  931. `Argument description:'
  932.         * GROUP1
  933.  
  934.         * GROUP2
  935.  
  936.         * GROUP3
  937.  
  938.         * GROUP4
  939.  
  940.         * GROUP5
  941.  
  942.         * GROUP6
  943.  
  944.         * GROUP7
  945.  
  946.         * GROUP8
  947.  
  948.           Each group can be switched on (`ON' or `YES' or off (`OFF' or
  949.           `NO'). If you call `CHANGEGROUPS' without any parameter, the
  950.           group selection keeps unchanged.
  951.  
  952.         * ALL
  953.  
  954.           Instead of activating each of the 8 groups, you may simply
  955.           use this parameter to active all groups.
  956.  
  957. `Example:'
  958.  
  959.           /* Activate groups 1 through 6                           */
  960.           /* The group selection for groups 7 and 8 is not changed */
  961.           
  962.           ADDRESS 'DFA'
  963.           
  964.           CHANGEGROUPS GROUP1 ON GROUP2 ON GROUP3 ON GROUP4 ON GROUP5 ON GROUP6 ON
  965.  
  966. The CLEARALL Command
  967. ....................
  968.  
  969. `Syntax:'
  970.      CLEARALL
  971.  
  972. `Function:'
  973.      All items of the address list are deselected.
  974.  
  975. `Results:'
  976.      The following error codes can be returned in `RC2':
  977.  
  978.         * RXERR_ENVCHANGED
  979.  
  980.         * RXERR_NONETWORKCLEAR
  981.  
  982. `Note:'
  983.      Only addresses that correspond to the current group selection are
  984.      deselected!
  985.  
  986. The DESELECT Command
  987. ....................
  988.  
  989. `Syntax:'
  990.      DESELECT
  991.  
  992. `Function:'
  993.      The current entry (it one exists) is deselected.
  994.  
  995. `Results:'
  996.      The following error codes can be returned in `RC2':
  997.  
  998.         * RXERR_NOCURRENT
  999.  
  1000.         * RXERR_ENVCHANGED
  1001.  
  1002. The DIAL Command
  1003. ................
  1004.  
  1005. `Syntax:'
  1006.      DIAL
  1007.  
  1008. `Function:'
  1009.      The current address (if one exists) is dialed up.
  1010.  
  1011. `Results:'
  1012.      The following error codes can be returned in `RC2':
  1013.  
  1014.         * RXERR_SERNOCARRIER
  1015.  
  1016.         * RXERR_SERNODIALTONE
  1017.  
  1018.         * RXERR_SERRING
  1019.  
  1020.         * RXERR_SERBUSY
  1021.  
  1022.         * RXERR_SEROK
  1023.  
  1024.         * RXERR_SERERROR
  1025.  
  1026.         * RXERR_SERCONNECT
  1027.  
  1028.         * RXERR_SERVOICE
  1029.  
  1030.         * RXERR_SERUNKNOWN
  1031.  
  1032.         * RXERR_NOSERIALDEV
  1033.  
  1034.         * RXERR_NOPHONENUM
  1035.  
  1036.         * RXERR_ENVCHANGED
  1037.  
  1038. The EDIT Command
  1039. ................
  1040.  
  1041. `Syntax:'
  1042.      EDIT [SALUTATION <string>] [FIRST <string>] [NAME <string>]
  1043.      [STREET <string>] [CO <string>] [ZIP <string>] [CITY <string>]
  1044.      [STATE <string>] [COUNTRY <string>] [BIRTHDAY <string>] [PHONE
  1045.      <string>] [FAX <string>] [EMAIL1 <string>] [EMAIL2 <string>]
  1046.      [EMAIL3 <string>] [COMMENT <string>] [GROUP1] [GROUP2] [GROUP3]
  1047.      [GROUP4] [GROUP5] [GROUP6] [GROUP7] [GROUP8] [SELECT] [EXTERNAL
  1048.      <string>]
  1049.  
  1050. `Argument template:'
  1051.      SALUTATION/K, FIRST/K, NAME/K, STREET/K, CO/K, ZIP/K, CITY/K,
  1052.      STATE/K, COUNTRY/K, BIRTHDAY/K, PHONE/K, FAX/K, EMAIL1/K,
  1053.      EMAIL2/K, EMAIL3/K, COMMENT/K, GROUP1/T, GROUP2/T, GROUP3/T,
  1054.      GROUP4/T, GROUP5/T, GROUP6/T, GROUP7/T, GROUP8/T, SELECT/T,
  1055.      EXTERNAL/K
  1056.  
  1057. `Function:'
  1058.      The current address (if one exists) is modified in the given
  1059.      fields.  The former contents of these fields is deleted. Fields
  1060.      that are not given as parameters are not changed and keep their
  1061.      former contents.  Please notice that parameters that contain
  1062.      spaces have to be set into quotes, for example:
  1063.  
  1064.               EDIT 'COMMENT="A test that contains spaces"'
  1065.  
  1066.  
  1067.      Please remember to use `'' for the outer and `"' for the inner
  1068.      quotes!
  1069.  
  1070.      Since version 2.2 of *DFA* has been completed, the behavior of the
  1071.      `/T' modifiers has slightly changed. If you want to switch a `/T'
  1072.      parameter on, you have to supply a `ON' or `YES' just behind the
  1073.      according parameter. To switch a parameter off, use the keywords
  1074.      `OFF' or `NO', e.g.
  1075.  
  1076.  
  1077.               EDIT GROUP1 ON GROUP2 OFF GROUP8 ON SELECT ON
  1078.  
  1079. `Argument description:'
  1080.         * SALUTATION <string>
  1081.  
  1082.           Salutation
  1083.  
  1084.         * FIRST <string>
  1085.  
  1086.           First name
  1087.  
  1088.         * NAME <string>
  1089.  
  1090.           Name
  1091.  
  1092.         * STREET <string>
  1093.  
  1094.           Street
  1095.  
  1096.         * CO <string>
  1097.  
  1098.           c/o
  1099.  
  1100.         * ZIP <string>
  1101.  
  1102.           Postal code
  1103.  
  1104.         * CITY <string>
  1105.  
  1106.           City
  1107.  
  1108.         * STATE <string>
  1109.  
  1110.           State
  1111.  
  1112.         * COUNTRY <string>
  1113.  
  1114.           Country
  1115.  
  1116.         * BIRTHDAY <string>
  1117.  
  1118.           Birthday
  1119.  
  1120.         * PHONE <string>
  1121.  
  1122.           Phone number
  1123.  
  1124.         * FAX <string>
  1125.  
  1126.           Telefax number
  1127.  
  1128.         * EMAIL1 <string>
  1129.  
  1130.           Email address No. 1
  1131.  
  1132.         * EMAIL2 <string>
  1133.  
  1134.           Email address No. 2
  1135.  
  1136.         * EMAIL3 <string>
  1137.  
  1138.           Email address No. 3
  1139.  
  1140.         * COMMENT <string>
  1141.  
  1142.           Comment
  1143.  
  1144.         * GROUP1
  1145.  
  1146.           Group No. 1
  1147.  
  1148.         * GROUP2
  1149.  
  1150.           Group No. 2
  1151.  
  1152.         * GROUP3
  1153.  
  1154.           Group No. 3
  1155.  
  1156.         * GROUP4
  1157.  
  1158.           Group No. 4
  1159.  
  1160.         * GROUP5
  1161.  
  1162.           Group No. 5
  1163.  
  1164.         * GROUP6
  1165.  
  1166.           Group No. 6
  1167.  
  1168.         * GROUP7
  1169.  
  1170.           Group No. 7
  1171.  
  1172.         * GROUP8
  1173.  
  1174.           Group No. 8
  1175.  
  1176.         * SELECT
  1177.  
  1178.           Selection state, i.e. `ON' or `OFF'.
  1179.  
  1180.         * EXTERNAL <string>
  1181.  
  1182.           The *filename* of the external file.
  1183.  
  1184. `Results:'
  1185.      The following error codes can be returned in `RC2':
  1186.  
  1187.         * RXERR_NODIR
  1188.  
  1189.         * RXERR_NOFILE
  1190.  
  1191.         * RXERR_NOCURRENT
  1192.  
  1193.         * RXERR_ENVCHANGED
  1194.  
  1195.         * RXERR_NONETWORKEDIT
  1196.  
  1197. The EDITTEMPLATE Command
  1198. ........................
  1199.  
  1200. `Syntax:'
  1201.      EDITTEMPLATE [SALUTATION <string>] [FIRST <string>] [NAME
  1202.      <string>] [STREET <string>] [CO <string>] [ZIP <string>] [CITY
  1203.      <string>] [STATE <string>] [COUNTRY <string>] [BIRTHDAY <string>]
  1204.      [PHONE <string>] [FAX <string>] [EMAIL1 <string>] [EMAIL2
  1205.      <string>] [EMAIL3 <string>] [COMMENT <string>] [<group1>]
  1206.      [<group2>] [<group3>] [<group4>] [<group5>] [<group6>] [<group7>]
  1207.      [<group8>] [<select>]
  1208.  
  1209. `Argument template:'
  1210.      SALUTATION/K, FIRST/K, NAME/K, STREET/K, CO/K, ZIP/K, CITY/K,
  1211.      STATE/K, COUNTRY/K, BIRTHDAY/K, PHONE/K, FAX/K, EMAIL1/K,
  1212.      EMAIL2/K, EMAIL3/K, COMMENT/K, GROUP1/T, GROUP2/T, GROUP3/T,
  1213.      GROUP4/T, GROUP5/T, GROUP6/T, GROUP7/T, GROUP8/T, SELECT/T
  1214.  
  1215. `Function:'
  1216.      Changes the template address.
  1217.  
  1218.      This command makes most sense within the AREXX script that may be
  1219.      used in connection with the the `New' function of the *DFA-Editor*.
  1220.  
  1221. `Argument description:'
  1222.         * SALUTATION <string>
  1223.  
  1224.           Salutation
  1225.  
  1226.         * FIRST <string>
  1227.  
  1228.           First name
  1229.  
  1230.         * NAME <string>
  1231.  
  1232.           Name
  1233.  
  1234.         * STREET <string>
  1235.  
  1236.           Street
  1237.  
  1238.         * CO <string>
  1239.  
  1240.           c/o
  1241.  
  1242.         * ZIP <string>
  1243.  
  1244.           Postal code
  1245.  
  1246.         * CITY <string>
  1247.  
  1248.           City
  1249.  
  1250.         * STATE <string>
  1251.  
  1252.           State
  1253.  
  1254.         * COUNTRY <string>
  1255.  
  1256.           Country
  1257.  
  1258.         * BIRTHDAY <string>
  1259.  
  1260.           Birthday
  1261.  
  1262.         * PHONE <string>
  1263.  
  1264.           Phone number
  1265.  
  1266.         * FAX <string>
  1267.  
  1268.           Telefax number
  1269.  
  1270.         * EMAIL1 <string>
  1271.  
  1272.           Email address No. 1
  1273.  
  1274.         * EMAIL2 <string>
  1275.  
  1276.           Email address No. 2
  1277.  
  1278.         * EMAIL3 <string>
  1279.  
  1280.           Email address No. 3
  1281.  
  1282.         * COMMENT <string>
  1283.  
  1284.           Comment
  1285.  
  1286.         * GROUP1
  1287.  
  1288.           Group No. 1
  1289.  
  1290.         * GROUP2
  1291.  
  1292.           Group No. 2
  1293.  
  1294.         * GROUP3
  1295.  
  1296.           Group No. 3
  1297.  
  1298.         * GROUP4
  1299.  
  1300.           Group No. 4
  1301.  
  1302.         * GROUP5
  1303.  
  1304.           Group No. 5
  1305.  
  1306.         * GROUP6
  1307.  
  1308.           Group No. 6
  1309.  
  1310.         * GROUP7
  1311.  
  1312.           Group No. 7
  1313.  
  1314.         * GROUP8
  1315.  
  1316.           Group No. 8
  1317.  
  1318.         * SELECT
  1319.  
  1320.           Selection state, i.e. `ON' or `OFF'.
  1321.  
  1322. `Results:'
  1323.      The following error codes can be returned in `RC2':
  1324.  
  1325.         * RXERR_NONETWORKEDIT
  1326.  
  1327. `Note:'
  1328.      Please notice that the template address is not used by the AREXX
  1329.      interface, but only by the *DFA-Editor*.
  1330.  
  1331. `Example:'
  1332.  
  1333.           /*
  1334.            * Example for an AREXX script that may be used in
  1335.            * connection with the New function of the DFAEditor.
  1336.            *
  1337.            * It sets the salutation and name fields with contents
  1338.            *
  1339.            */
  1340.           
  1341.           address 'DFA'
  1342.           
  1343.           edittemplate 'salutation="Mr" name="<still unknown>"'
  1344.           
  1345.           exit
  1346.  
  1347. The FIRST Command
  1348. .................
  1349.  
  1350. `Syntax:'
  1351.      FIRST [VAR <name>] [STEM <name>]
  1352.  
  1353. `Argument template:'
  1354.      VAR/K, STEM/K
  1355.  
  1356. `Function:'
  1357.      The first address of the address list becomes the current one and
  1358.      is returned in the `ADDRESS' variable.
  1359.  
  1360. `Argument description:'
  1361.         * VAR <name>
  1362.  
  1363.         * STEM <name>
  1364.  
  1365. `Results:'
  1366.         * .ADDRESS.COUNT
  1367.  
  1368.         * .ADDRESS.x
  1369.  
  1370.      The following error codes can be returned in `RC2':
  1371.  
  1372.         * RXERR_NOFIRST
  1373.  
  1374.         * RXERR_ENVCHANGED
  1375.  
  1376. The FREELOCK Command
  1377. ....................
  1378.  
  1379. `Syntax:'
  1380.      FREELOCK
  1381.  
  1382. `Function:'
  1383.      If you've got write access using the `ATTEMPTLOCK' command (cf.
  1384.      ATTEMPTLOCK), you should free the locked file as soon as possible
  1385.      using the `FREELOCK' command, to give other members of the LAN the
  1386.      chance to access this address file.
  1387.  
  1388. `Results:'
  1389.      The following error codes can be returned in `RC2':
  1390.  
  1391.         * RXERR_NOSAVE
  1392.  
  1393.         * RXERR_ENVCHANGED
  1394.  
  1395. `Note:'
  1396.      Makes sense in network mode only!
  1397.  
  1398. The GETCURRENT Command
  1399. ......................
  1400.  
  1401. `Syntax:'
  1402.      GETCURRENT [VAR <name>] [STEM <name>]
  1403.  
  1404. `Argument template:'
  1405.      VAR/K, STEM/K
  1406.  
  1407. `Function:'
  1408.      The current entry (if there exists one) is returned.
  1409.  
  1410. `Argument description:'
  1411.         * VAR <name>
  1412.  
  1413.         * STEM <name>
  1414.  
  1415. `Results:'
  1416.         * .ADDRESS.COUNT
  1417.  
  1418.         * .ADDRESS.x
  1419.  
  1420.      The following error codes can be returned in `RC2':
  1421.  
  1422.         * RXERR_NOCURRENT
  1423.  
  1424.         * RXERR_ENVCHANGED
  1425.  
  1426. The GETPREFS Command
  1427. ....................
  1428.  
  1429. `Syntax:'
  1430.      GETPREFS [SHOWAPPICON|APPICON] [AUTOSAVE|AS] [MAKEICON]
  1431.      [SECRETMODE|SM] [NETWORKMODE|NWMODE] [NETWORKRETRIES|NWRETRIES]
  1432.      [NETWORKDELAY|NWDELAY] [GROUPNAME1] [GROUPNAME2] [GROUPNAME3]
  1433.      [GROUPNAME4] [GROUPNAME5] [GROUPNAME6] [GROUPNAME7] [GROUPNAME8]
  1434.      [GROUPRELATION|GREL] [MODEMBAUD|MBAUD] [MODEMINIT|MINIT]
  1435.      [MODEMEXIT|MEXIT] [MODEMPREDIAL|MPDIAL] [MODEMSUFFDIAL|MSDIAL]
  1436.      [MODEMSERDEV|MDEV] [MODEMSERDEVNO|MDEVNO] [MODEMUSEODU|MODU]
  1437.      [MODEMRETRIES|MRETRIES] [MODEMDELAY|MDELAY]
  1438.      [PATHSADDRESSFILE|PAFILE] [PATHSEXTERNALDIR|PEXT]
  1439.      [PATHSASCIIED|PASCIIED] [PATHSASCIISHOW|PASCIISHOW] [SORTBY1]
  1440.      [SORTBY2] [SORTBY3] [SORTBY4] [VAR <name>] [STEM <name>]
  1441.  
  1442. `Argument template:'
  1443.      SHOWAPPICON=APPICON/S, AUTOSAVE=AS/S, MAKEICON/S, SECRETMODE=SM/S,
  1444.      NETWORKMODE=NWMODE/S, NETWORKRETRIES=NWRETRIES/S,
  1445.      NETWORKDELAY=NWDELAY/S, GROUPNAME1/S, GROUPNAME2/S, GROUPNAME3/S,
  1446.      GROUPNAME4/S, GROUPNAME5/S, GROUPNAME6/S, GROUPNAME7/S,
  1447.      GROUPNAME8/S, GROUPRELATION=GREL/S, MODEMBAUD=MBAUD/S,
  1448.      MODEMINIT=MINIT/S, MODEMEXIT=MEXIT/S, MODEMPREDIAL=MPDIAL/S,
  1449.      MODEMSUFFDIAL=MSDIAL/S, MODEMSERDEV=MDEV/S,
  1450.      MODEMSERDEVNO=MDEVNO/K/S, MODEMUSEODU=MODU/S,
  1451.      MODEMRETRIES=MRETRIES/K/S, MODEMDELAY=MDELAY/S,
  1452.      PATHSADDRESSFILE=PAFILE/S, PATHSEXTERNALDIR=PEXT/S,
  1453.      PATHSASCIIED=PASCIIED/S, PATHSASCIISHOW=PASCIISHOW/S, SORTBY1/S,
  1454.      SORTBY2/S, SORTBY3/S, SORTBY4/S, VAR/K, STEM/K
  1455.  
  1456. `Function:'
  1457.      Returns the settings of DFA. Only the first argument is used. The
  1458.      return value can be found in `RESULT' or within the variable you
  1459.      can give together with the `VAR' or `STEM' keyword.
  1460.  
  1461. `Argument description:'
  1462.         * SHOWAPPICON|APPICON
  1463.  
  1464.           AppIcon:
  1465.  
  1466.              - 0 Show the AppIcon
  1467.  
  1468.              - 1 Don't show the AppIcon
  1469.  
  1470.         * AUTOSAVE|AS
  1471.  
  1472.           Automatic saving of the address file.
  1473.  
  1474.              - ALWAYS Saves the address file as soon as you leave the
  1475.                *DFA-Editors*.
  1476.  
  1477.              - REMOVE Thes the address file only, if you terminate the
  1478.                complete *DFA* application.
  1479.  
  1480.              - ASK When you leave the *DFA-Editor*, you're asked, if
  1481.                you wnat to save the address file.
  1482.  
  1483.         * MAKEICON
  1484.  
  1485.           Generates an icon for the address files.
  1486.  
  1487.              - 0 Icon generation off
  1488.  
  1489.              - 1 Icon generation on
  1490.  
  1491.         * SECRETMODE|SM
  1492.  
  1493.           Secret mode:
  1494.  
  1495.              - 0 Secret mode off
  1496.  
  1497.              - 1 Secret mode on
  1498.  
  1499.         * NETWORKMODE|NWMODE
  1500.  
  1501.           Network mode:
  1502.  
  1503.              - 0 Network mode off
  1504.  
  1505.              - 1 Network mode on
  1506.  
  1507.         * NETWORKRETRIES|NWRETRIES
  1508.  
  1509.           Number of retries, when *DFA* tries to get write access to an
  1510.           address file.
  1511.  
  1512.         * NETWORKDELAY|NWDELAY
  1513.  
  1514.           Number of seconds to wait between two retries.
  1515.  
  1516.         * GROUPNAME1
  1517.  
  1518.         * GROUPNAME2
  1519.  
  1520.         * GROUPNAME3
  1521.  
  1522.         * GROUPNAME4
  1523.  
  1524.         * GROUPNAME5
  1525.  
  1526.         * GROUPNAME6
  1527.  
  1528.         * GROUPNAME7
  1529.  
  1530.         * GROUPNAME8
  1531.  
  1532.           Name of the different groups.
  1533.  
  1534.         * GROUPRELATION|GREL
  1535.  
  1536.           Group relation:
  1537.  
  1538.              - OR via `OR'
  1539.  
  1540.              - AND via `UND'.
  1541.  
  1542.         * MODEMBAUD|MBAUD
  1543.  
  1544.           The baud rate of the modem. Possible values are:
  1545.  
  1546.              - 1200
  1547.  
  1548.              - 2400
  1549.  
  1550.              - 4800
  1551.  
  1552.              - 7200
  1553.  
  1554.              - 9600
  1555.  
  1556.              - 12000
  1557.  
  1558.              - 14400
  1559.  
  1560.              - 16800
  1561.  
  1562.              - 19200
  1563.  
  1564.              - 31250
  1565.  
  1566.              - 38400
  1567.  
  1568.              - 57600
  1569.  
  1570.              - 64000
  1571.  
  1572.              - 76800
  1573.  
  1574.              - 115000
  1575.  
  1576.         * MODEMINIT|MINIT
  1577.  
  1578.           Init string.
  1579.  
  1580.         * MODEMEXIT|MEXIT
  1581.  
  1582.           Exit string.
  1583.  
  1584.         * MODEMPREDIAL|MPDIAL
  1585.  
  1586.           Predial string.
  1587.  
  1588.         * MODEMSUFFDIAL|MSDIAL
  1589.  
  1590.           String, which is sent directly after the phone number.
  1591.  
  1592.         * MODEMSERDEV|MDEV
  1593.  
  1594.           The name of the serial device.
  1595.  
  1596.         * MODEMSERDEVNO|MDEVNO
  1597.  
  1598.           The number of the serial device.
  1599.  
  1600.         * MODEMUSEODU|MODU
  1601.  
  1602.           Usage of the `OwnDevUnit.library':
  1603.  
  1604.              - 0 The `OwnDevUnit.library' is not used.
  1605.  
  1606.              - 1 The `OwnDevUnit.library' is used.
  1607.  
  1608.         * MODEMRETRIES|MRETRIES
  1609.  
  1610.           Number of retries, if the line is busy.
  1611.  
  1612.         * MODEMDELAY|MDELAY
  1613.  
  1614.           Delay (in seconds) between two retries.
  1615.  
  1616.         * PATHSADDRESSFILE|PAFILE
  1617.  
  1618.           Path and name of the address file.
  1619.  
  1620.         * PATHSEXTERNALDIR|PEXT
  1621.  
  1622.           Name of the drawer that contains the external files.
  1623.  
  1624.         * PATHSASCIIED|PASCIIED
  1625.  
  1626.           Name (incl. path) of the text editor.
  1627.  
  1628.         * PATHSASCIISHOW|PASCIISHOW
  1629.  
  1630.           Name (incl. path) of the text viewer.
  1631.  
  1632.         * SORTBY1
  1633.  
  1634.         * SORTBY2
  1635.  
  1636.         * SORTBY3
  1637.  
  1638.         * SORTBY4
  1639.  
  1640.           Each parameter can return one of the following keywords:
  1641.  
  1642.              - SALUTATION
  1643.  
  1644.              - FIRSTNAME
  1645.  
  1646.              - NAME
  1647.  
  1648.              - CO
  1649.  
  1650.              - STREET
  1651.  
  1652.              - ZIP
  1653.  
  1654.              - CITY
  1655.  
  1656.              - STATE
  1657.  
  1658.              - COUNTRY
  1659.  
  1660.              - BIRTHDAY
  1661.  
  1662.              - PHONE
  1663.  
  1664.              - FAX
  1665.  
  1666.              - EMAIL1
  1667.  
  1668.              - EMAIL2
  1669.  
  1670.              - EMAIL3
  1671.  
  1672.              - COMMENT
  1673.  
  1674.              - CLEAR Deleted sort criteria, i.e. none.
  1675.  
  1676.         * VAR <name>
  1677.  
  1678.         * STEM <name>
  1679.  
  1680. `Results:'
  1681.      The return value depends on the argument you supply; see above.
  1682.  
  1683. `Note:'
  1684.      -
  1685.  
  1686. `Example:'
  1687.      -
  1688.  
  1689. The GETTEMPLATE Command
  1690. .......................
  1691.  
  1692. `Syntax:'
  1693.      GETTEMPLATE [VAR <name>] [STEM <name>]
  1694.  
  1695. `Argument template:'
  1696.      VAR/K, STEM/K
  1697.  
  1698. `Function:'
  1699.      The current template address is returned.
  1700.  
  1701. `Argument description:'
  1702.         * VAR <name>
  1703.  
  1704.         * STEM <name>
  1705.  
  1706. `Results:'
  1707.         * .ADDRESS.COUNT
  1708.  
  1709.         * .ADDRESS.x
  1710.  
  1711.      The following error codes can be returned in `RC2':
  1712.  
  1713.         * RXERR_MEM
  1714.  
  1715. The GUI Command
  1716. ...............
  1717.  
  1718. `Syntax:'
  1719.      GUI [<input>] [<output>]
  1720.  
  1721. `Argument template:'
  1722.      INPUT/T, OUTPUT/T
  1723.  
  1724. `Function:'
  1725.      Using this command you may lock or free the *DFAEditor's* output
  1726.      and input respectively.
  1727.  
  1728.      After you've locked the input of the *DFAEditor* using `GUI INPUT
  1729.      OFF', it is no longer possible to do any input to the *DFAEditor*,
  1730.      i.e. you cannot select any gadgets or menus.
  1731.  
  1732.      If you've used `GUI OUTPUT OFF' to lock the output of the
  1733.      *DFAEditor*, the address and teh panel listview of the *DFAEditor*
  1734.      main window are no longer updated, when you more through the
  1735.      address list using `NEXT' or `PREV' for example.  Not before
  1736.      you've used the command `GUI OUTPUT ON', the displayed is
  1737.      "activated" again.
  1738.  
  1739. `Argument description:'
  1740.         * INPUT
  1741.  
  1742.           Disables or enables user input into the *DFAEditor*.
  1743.  
  1744.         * OUTPUT
  1745.  
  1746.           Disables the refreshing of the *DFAEditor*'s address and panel
  1747.           listview.
  1748.  
  1749. `Results:'
  1750.      The following error codes can be returned in `RC2':
  1751.  
  1752.         * RXERR_SYNTAX
  1753.  
  1754. `Note:'
  1755.      Please make sure that you enable input and/or output, before your
  1756.      Arexx script ends, if you've formerly disabled them.
  1757.  
  1758. The ICONIFY Command
  1759. ...................
  1760.  
  1761. `Syntax:'
  1762.      ICONIFY
  1763.  
  1764. `Argument template:'
  1765. `Function:'
  1766.      The *DFA-Editor* is stopped, if it is currently running. The
  1767.      *DFA-Server*, however, keeps running, so you still can reach the
  1768.      *DFA-Editor* by pushing the hotkey.
  1769.  
  1770. `Results:'
  1771.      The following error codes can be returned in `RC2':
  1772.  
  1773.         * RXERR_NOICONIFY
  1774.  
  1775. The KILL Command
  1776. ................
  1777.  
  1778. `Syntax:'
  1779.      KILL [CURRENT] [SELECTED]
  1780.  
  1781. `Argument template:'
  1782.      CURRENT/S, SELECTED/S
  1783.  
  1784. `Function:'
  1785.      The current entry (`CURRENT') or all selected (`SELECTED')
  1786.      addresses are deleted! If you use the `KILL' command without a
  1787.      parameter, it has the same meaning as if you had given the
  1788.      `CURRENT' parameter, i.e. the current address (as long as there is
  1789.      one) is deleted.
  1790.  
  1791. `Argument description:'
  1792.         * CURRENT
  1793.  
  1794.           The current address will be deleted. Can be left out.
  1795.  
  1796.         * SELECTED
  1797.  
  1798.           All selected addresses will be deleted.
  1799.  
  1800. `Results:'
  1801.      The following error codes can be returned in `RC2':
  1802.  
  1803.         * RXERR_ENVCHANGED
  1804.  
  1805.         * RXERR_NONETWORKKILL
  1806.  
  1807. `Note:'
  1808.      No safety requester will pop up! The addresses are deleted even if
  1809.      they have been modified before!
  1810.  
  1811. The LAST Command
  1812. ................
  1813.  
  1814. `Syntax:'
  1815.      LAST [VAR <name>] [STEM <name>]
  1816.  
  1817. `Argument template:'
  1818.      VAR/K, STEM/K
  1819.  
  1820. `Function:'
  1821.      The last address becomes the current one and is returned in
  1822.      `ADDRESS'.
  1823.  
  1824. `Argument description:'
  1825.         * VAR <name>
  1826.  
  1827.         * STEM <name>
  1828.  
  1829. `Results:'
  1830.         * .ADDRESS.COUNT
  1831.  
  1832.         * .ADDRESS.x
  1833.  
  1834. `Results:'
  1835.      The following error codes can be returned in `RC2':
  1836.  
  1837.         * RXERR_ENVCHANGED
  1838.  
  1839. The LOAD Command
  1840. ................
  1841.  
  1842. `Syntax:'
  1843.      LOAD [FILENAME] <string> [FORCE] [PROMPT]
  1844.  
  1845. `Argument template:'
  1846.      FILENAME, FORCE/S, PROMPT/S
  1847.  
  1848. `Function:'
  1849.      The given address file is loaded, if the previously loaded one had
  1850.      not been changed. You may force the loading of the new addresses by
  1851.      giving the `FORCE' parameter. Please notice that using the `FORCE'
  1852.      option throws away any changes you applied to the former loaded
  1853.      addresses.
  1854.  
  1855.      Instead of giving a filename, it is possible to use the `PROMPT'
  1856.      parameter, which will supply a file requester to input the desired
  1857.      filename.
  1858.  
  1859. `Argument description:'
  1860.         * FILENAME <string>
  1861.  
  1862.           Address file to be loaded.
  1863.  
  1864.         * FORCE
  1865.  
  1866.           Forces loading a new address file.
  1867.  
  1868.         * PROMPT
  1869.  
  1870.           Supplies a file requester to select the desired filename.
  1871.  
  1872. `Results:'
  1873.      The following error codes can be returned in `RC2':
  1874.  
  1875.         * RXERR_NOLOAD
  1876.  
  1877.         * RXERR_ENVCHANGED
  1878.  
  1879.         * RXERR_MODIFIED
  1880.  
  1881.         * RXERR_NOFILENAME
  1882.  
  1883. The LOADPREFS Command
  1884. .....................
  1885.  
  1886. `Syntax:'
  1887.      LOADPREFS [<filename>] [RESET] [PROMPT]
  1888.  
  1889. `Argument template:'
  1890.      FILENAME, RESET/S, PROMPT/S
  1891.  
  1892. `Function:'
  1893.      Loads a preferences file.
  1894.  
  1895. `Argument description:'
  1896.         * FILENAME Filename of the preferences file.
  1897.  
  1898.           If you give no filename, the file `ENV:DFA/DFA.prefs' is
  1899.           loaded.
  1900.  
  1901.         * RESET Resets the settings to their default values.
  1902.  
  1903.         * PROMPT A filerequester pops up and lets you enter the name of
  1904.           the preferences file to load.
  1905.  
  1906. `Results:'
  1907.      The following error codes can be returned in `RC2':
  1908.  
  1909.         * RXERR_NOFILENAME
  1910.  
  1911.         * RXERR_NOMEM
  1912.  
  1913. `Note:'
  1914.         * There is no savety requester.
  1915.  
  1916.         * This command works only in the registered version of *DFA*
  1917.  
  1918. The NEW Command
  1919. ...............
  1920.  
  1921. `Syntax:'
  1922.      NEW [SALUTATION <string>] [FIRST <string>] [NAME <string>] [STREET
  1923.      <string>] [CO <string>] [ZIP <string>] [CITY <string>] [STATE
  1924.      <string>] [COUNTRY <string>] [BIRTHDAY <string>] [PHONE <string>]
  1925.      [FAX <string>] [EMAIL1 <string>] [EMAIL2 <string>] [EMAIL3
  1926.      <string>] [COMMENT <string>] [GROUP1] [GROUP2] [GROUP3] [GROUP4]
  1927.      [GROUP5] [GROUP6] [GROUP7] [GROUP8] [SELECT] [EXTERNAL <string>]
  1928.  
  1929. `Argument template:'
  1930.      SALUTATION/K, FIRST/K, NAME/K, STREET/K, CO/K, ZIP/K, CITY/K,
  1931.      STATE/K, COUNTRY/K, BIRTHDAY/K, PHONE/K, FAX/K, EMAIL1/K,
  1932.      EMAIL2/K, EMAIL3/K, COMMENT/K, GROUP1/S, GROUP2/S, GROUP3/S,
  1933.      GROUP4/S, GROUP5/S, GROUP6/S, GROUP7/S, GROUP8/S, SELECT/S,
  1934.      EXTERNAL/K
  1935.  
  1936. `Function:'
  1937.      A new address is created using the provided data.
  1938.  
  1939.      Please notice that any templates you may have entered, will not be
  1940.      used by the Arexx interface.
  1941.  
  1942. `Argument description:'
  1943.         * SALUTATION <string>
  1944.  
  1945.           Salutation
  1946.  
  1947.         * FIRST <string>
  1948.  
  1949.           First name
  1950.  
  1951.         * NAME <string>
  1952.  
  1953.           Name
  1954.  
  1955.         * STREET <string>
  1956.  
  1957.           Street
  1958.  
  1959.         * CO <string>
  1960.  
  1961.           c/o
  1962.  
  1963.         * ZIP <string>
  1964.  
  1965.           Postal code
  1966.  
  1967.         * CITY <string>
  1968.  
  1969.           City
  1970.  
  1971.         * STATE <string>
  1972.  
  1973.           State
  1974.  
  1975.         * COUNTRY <string>
  1976.  
  1977.           Country
  1978.  
  1979.         * BIRTHDAY <string>
  1980.  
  1981.           Birthday
  1982.  
  1983.         * PHONE <string>
  1984.  
  1985.           Phone number
  1986.  
  1987.         * FAX <string>
  1988.  
  1989.           Telefax number
  1990.  
  1991.         * EMAIL1 <string>
  1992.  
  1993.           EMail address No. 1
  1994.  
  1995.         * EMAIL2 <string>
  1996.  
  1997.           EMail address No. 2
  1998.  
  1999.         * EMAIL3 <string>
  2000.  
  2001.           EMail address No. 3
  2002.  
  2003.         * COMMENT <string>
  2004.  
  2005.           Comment
  2006.  
  2007.         * GROUP1
  2008.  
  2009.           Group No. 1
  2010.  
  2011.         * GROUP2
  2012.  
  2013.           Group No. 2
  2014.  
  2015.         * GROUP3
  2016.  
  2017.           Group No. 3
  2018.  
  2019.         * GROUP4
  2020.  
  2021.           Group No. 4
  2022.  
  2023.         * GROUP5
  2024.  
  2025.           Group No. 5
  2026.  
  2027.         * GROUP6
  2028.  
  2029.           Group No. 6
  2030.  
  2031.         * GROUP7
  2032.  
  2033.           Group No. 7
  2034.  
  2035.         * GROUP8
  2036.  
  2037.           Group No. 8
  2038.  
  2039.         * SELECT
  2040.  
  2041.           Selection state, i.e. `0' or `1'.
  2042.  
  2043.         * EXTERNAL <string>
  2044.  
  2045.           The *filename* of the external file.
  2046.  
  2047. The NEWFILE Command
  2048. ...................
  2049.  
  2050. `Syntax:'
  2051.      NEWFILE [<filename>] [FORCE] [PROMPT]
  2052.  
  2053. `Argument template:'
  2054.      FILENAME, FORCE/S, PROMPT/S
  2055.  
  2056. `Function:'
  2057.      This command makes it possible to create a new address file. The
  2058.      command fails if the previously loaded address file has been
  2059.      modifed.  This behaviour can be changed by giving the `FORCE'
  2060.      option additionally.
  2061.  
  2062.      Using the parameter `PROMPT' enables a file requester to input the
  2063.      new filename.
  2064.  
  2065. `Argument description:'
  2066.         * FILENAME
  2067.  
  2068.           New filename.
  2069.  
  2070.         * FORCE
  2071.  
  2072.           Forces the creation of the new file, even if the old address
  2073.           file has been modified.
  2074.  
  2075.         * PROMPT
  2076.  
  2077.           Supplies a file requester to input the new filename.
  2078.  
  2079. `Results:'
  2080.      The following error codes can be returned in `RC2':
  2081.  
  2082.         * RXERR_NODIR
  2083.  
  2084.         * RXERR_NOEXTERNAL
  2085.  
  2086.         * RXERR_ENVCHANGED
  2087.  
  2088.         * RXERR_NONETWORKNEW
  2089.  
  2090. The NEXT Command
  2091. ................
  2092.  
  2093. `Syntax:'
  2094.      NEXT [VAR <name>] [STEM <name>]
  2095.  
  2096. `Argument template:'
  2097.      VAR/K, STEM/K
  2098.  
  2099. `Function:'
  2100.      The next address becomes the current one and is returned.
  2101.  
  2102. `Argument description:'
  2103.         * VAR <name>
  2104.  
  2105.         * STEM <name>
  2106.  
  2107. `Results:'
  2108.         * .ADDRESS.COUNT
  2109.  
  2110.         * .ADDRESS.x
  2111.  
  2112.      The following error codes can be returned in `RC2':
  2113.  
  2114.         * RXERR_NONEXT
  2115.  
  2116.         * RXERR_ENVCHANGED
  2117.  
  2118. The NEXTSEL Command
  2119. ...................
  2120.  
  2121. `Syntax:'
  2122.      NEXTSEL [VAR <name>] [STEM <name>]
  2123.  
  2124. `Argument template:'
  2125.      VAR/K, STEM/K
  2126.  
  2127. `Function:'
  2128.      The next selected address becomes the current one and is returned.
  2129.  
  2130. `Argument description:'
  2131.         * VAR <name>
  2132.  
  2133.         * STEM <name>
  2134.  
  2135. `Results:'
  2136.         * .ADDRESS.COUNT
  2137.  
  2138.         * .ADDRESS.x
  2139.  
  2140.      The following error codes can be returned in `RC2':
  2141.  
  2142.         * RXERR_NONEXTSEL
  2143.  
  2144.         * RXERR_ENVCHANGED
  2145.  
  2146. The OPENEDITWINDOW Command
  2147. ..........................
  2148.  
  2149. `Syntax:'
  2150.      OPENEDITWINDOW
  2151.  
  2152. `Argument template:'
  2153. `Function:'
  2154.      The `Edit' window is opened and the current address is displayed,
  2155.      if there is one. The execution of the Arexx script is halted until
  2156.      the `Edit' window is closed.
  2157.  
  2158. `Argument description:'
  2159.      -
  2160.  
  2161. `Results:'
  2162.      The following error codes can be returned in `RC2':
  2163.  
  2164.         * RXERR_CURRENT
  2165.  
  2166. `Warning:'
  2167.      The `Edit' window is opened only if there is a current address,
  2168.      otherwise an error code is returned (see above).
  2169.  
  2170. The POPUP Command
  2171. .................
  2172.  
  2173. `Syntax:'
  2174.      POPUP
  2175.  
  2176. `Function:'
  2177.      If the *DFA-Editor* hasn't run up to now, it is started. Then it
  2178.      opens its main window. If the *DFA-Editor* is already running, it
  2179.      comes to front.
  2180.  
  2181. The PREV Command
  2182. ................
  2183.  
  2184. `Syntax:'
  2185.      PREV [VAR <name>] [STEM <name>]
  2186.  
  2187. `Argument template:'
  2188.      VAR/K, STEM/K
  2189.  
  2190. `Function:'
  2191.      The previous address becomes the current one and is returned.
  2192.  
  2193. `Argument description:'
  2194.         * VAR <name>
  2195.  
  2196.         * STEM <name>
  2197.  
  2198. `Results:'
  2199.         * .ADDRESS.COUNT
  2200.  
  2201.         * .ADDRESS.x
  2202.  
  2203.      The following error codes can be returned in `RC2':
  2204.  
  2205.         * RXERR_NOPREV
  2206.  
  2207.         * RXERR_ENVCHANGED
  2208.  
  2209. The PREVSEL Command
  2210. ...................
  2211.  
  2212. `Syntax:'
  2213.      PREVSEL [VAR <name>] [STEM <name>]
  2214.  
  2215. `Argument template:'
  2216.      VAR/K, STEM/K
  2217.  
  2218. `Function:'
  2219.      The previously selected address becomes the current one and is
  2220.      returned.
  2221.  
  2222. `Argument description:'
  2223.         * VAR <name>
  2224.  
  2225.         * STEM <name>
  2226.  
  2227. `Results:'
  2228.         * .ADDRESS.COUNT
  2229.  
  2230.         * .ADDRESS.x
  2231.  
  2232.      The following error codes can be returned in `RC2':
  2233.  
  2234.         * RXERR_NOPREVSEL
  2235.  
  2236.         * RXERR_ENVCHANGED
  2237.  
  2238. The PRINT Command
  2239. .................
  2240.  
  2241. `Syntax:'
  2242.      PRINT [WHICH <string>] [FILE <string>] [NLQ] [CONDENSED]
  2243.      [FORMFEED] [<form>]
  2244.  
  2245. `Argument template:'
  2246.      WHICH/K, FILE/K, NLQ/S, CONDENSED/S, FORMFEED/S, FORM/N
  2247.  
  2248. `Function:'
  2249.      Prints the desired addresses.
  2250.  
  2251. `Argument description:'
  2252.         * WHICH <string>
  2253.  
  2254.           `WHICH' can get the following keywords:
  2255.  
  2256.          `ALL'
  2257.                All addresses are printed
  2258.  
  2259.          `SELECTED'
  2260.                Only the selected addresses are printed
  2261.  
  2262.          `ACTIVE'
  2263.                Only the active entry (if there is one) is printed.
  2264.  
  2265.         * FILE <string>
  2266.  
  2267.           the `FILE' parameter gets a filename.  The addresses are
  2268.           written to this file instead of printed on the printer.
  2269.  
  2270.         * NLQ
  2271.  
  2272.           Prints the addresses in `NLQ'
  2273.  
  2274.         * CONDENSED
  2275.  
  2276.           Prints the addresses in condensed mode
  2277.  
  2278.         * FORMFEED
  2279.  
  2280.           After the last address has been printed, a formfeed is
  2281.           performed.  The settings from the *DFA-Editor* print window
  2282.           are not taken!
  2283.  
  2284.         * FORM
  2285.  
  2286.           The `FORM' keyword can get the numbers `0' through `4'.
  2287.           These numbers have the same meaning as the order of the print
  2288.           forms in the print window, but starting with `0' instead of
  2289.           `1'.
  2290.  
  2291.  
  2292.                0:    Short address list
  2293.                1:    Long address list
  2294.                2:    Telephone list
  2295.                3:    mailing labels, [70mm x 46mm]
  2296.                4:    address cards
  2297.  
  2298. `Results:'
  2299.      The following error codes can be returned in `RC2':
  2300.  
  2301.         * RXERR_SYNTAX
  2302.  
  2303.         * RXERR_ENVCHANGED
  2304.  
  2305.         * RXERR_OPNPRT
  2306.  
  2307.         * RXERR_CRTEXTIO
  2308.  
  2309.         * RXERR_CRTPORT
  2310.  
  2311.         * RXERR_WRITEALL
  2312.  
  2313.         * RXERR_WRITESEL
  2314.  
  2315.         * RXERR_WRITECURRENT
  2316.  
  2317. The SAVE Command
  2318. ................
  2319.  
  2320. `Syntax:'
  2321.      SAVE
  2322.  
  2323. `Function:'
  2324.      The addresses are saved under their current name.
  2325.  
  2326. `Results:'
  2327.      The following error codes can be returned in `RC2':
  2328.  
  2329.         * RXERR_ENVCHANGED
  2330.  
  2331.         * RXERR_NONETWORKSAVE
  2332.  
  2333. The SAVEAS Command
  2334. ..................
  2335.  
  2336. `Syntax:'
  2337.      SAVEAS [FILENAME] <string> [FORCE] [PROMPT]
  2338.  
  2339. `Argument template:'
  2340.      FILENAME, FORCE/S, PROMPT/S
  2341.  
  2342. `Function:'
  2343.      The addresses are saved under the given name.
  2344.  
  2345. `Argument description:'
  2346.         * FILENAME <string>
  2347.  
  2348.           Name of the address file to save.
  2349.  
  2350.         * FORCE
  2351.  
  2352.           Saves the addresses even if they have *not* been changed
  2353.           before.
  2354.  
  2355.         * PROMPT
  2356.  
  2357.           Supplies a file requester, which may be used to select the
  2358.           name of the address file to be saved.
  2359.  
  2360. `Results:'
  2361.      The following error codes can be returned in `RC2':
  2362.  
  2363.         * RXERR_NONETWORKSAVE
  2364.  
  2365.         * RXERR_NOSAVE
  2366.  
  2367.         * RXERR_ENVCHANGED
  2368.  
  2369. The SAVEASDEFAULT Command
  2370. .........................
  2371.  
  2372. `Syntax:'
  2373.      SAVEASDEFAULT
  2374.  
  2375. `Function:'
  2376.      The addresses are saved under the default name that you entered in
  2377.      the *DFA-Preferences* (default name: `s:adr.file').
  2378.  
  2379. `Results:'
  2380.      The following error codes can be returned in `RC2':
  2381.  
  2382.         * RXERR_NONETWORKSAVE
  2383.  
  2384.         * RXERR_NOSAVE
  2385.  
  2386.         * RXERR_ENVCHANGED
  2387.  
  2388. `Note:'
  2389.      Please use this command very carefully! If you've just loaded
  2390.      another than the default address file, the default address file is
  2391.      overwritten by this command!
  2392.  
  2393. The SAVEPREFS Command
  2394. .....................
  2395.  
  2396. `Syntax:'
  2397.      SAVEPREFS [<filename>] [PROMPT]
  2398.  
  2399. `Argument template:'
  2400.      FILENAME, PROMPT/S
  2401.  
  2402. `Function:'
  2403.      Saves the preferences file.
  2404.  
  2405. `Argument description:'
  2406.         * FILENAME Name of the preferences file to load.
  2407.  
  2408.           If there is no filename given, the preferences are saved to
  2409.           `ENV:DFA/DFA.prefs' and `ENVARC:DFA/DFA.prefs' respectively.
  2410.  
  2411.         * PROMPT A filerequester pops up and lets you select the name
  2412.           of the file to save the preferences in.
  2413.  
  2414. `Results:'
  2415.      The following error codes can be returned in `RC2':
  2416.  
  2417.         * RXERR_NOFILENAME
  2418.  
  2419.         * RXERR_NOMEM
  2420.  
  2421. `Note:'
  2422.      This command works only in the registered version of *DFA*.
  2423.  
  2424. The SEARCH Command
  2425. ..................
  2426.  
  2427. `Syntax:'
  2428.      SEARCH [PATTERN] <string> [IGNORECASE] [NOWILDCARDS] [ALL]
  2429.      [SALUTATION] [FIRST] [NAME] [STREET] [CO] [ZIP] [CITY] [STATE]
  2430.      [COUNTRY] [BIRTHDAY] [PHONE] [FAX] [EMAIL1] [EMAIL2] [EMAIL3]
  2431.      [COMMENT] [VAR <name>] [STEM <name>]
  2432.  
  2433. `Argument template:'
  2434.      PATTERN/A, IGNORECASE/S, NOWILDCARDS/S, ALL/S, SALUTATION/S,
  2435.      FIRST/S, NAME/S, STREET/S, CO/S, ZIP/S, CITY/S, STATE/S,
  2436.      COUNTRY/S, BIRTHDAY/S, PHONE/S, FAX/S, EMAIL1/S, EMAIL2/S,
  2437.      EMAIL3/S, COMMENT/S, VAR/K, STEM/K
  2438.  
  2439. `Function:'
  2440.      The given pattern is searched for. If an address fits into the
  2441.      pattern, it is returned. If the *DFA-Editor* is currently open,
  2442.      the address list scrolls to the corresponding place.
  2443.  
  2444. `Argument description:'
  2445.         * PATTERN <string>
  2446.  
  2447.           A search pattern. The known patterns from the Shell, as for
  2448.           example `#?' must be used (as long as you don't supply the
  2449.           `NOWILDCARDS' parameter). Please notice that partial strings
  2450.           are only found, if you put an `#?' before and/or behind the
  2451.           string (see example for details)! A detailed description of
  2452.           possible search patterns can be found in EditorSearch.
  2453.  
  2454.         * IGNORECASE
  2455.  
  2456.           Upper and lower case is treated as the same.
  2457.  
  2458.         * NOWILDCARDS
  2459.  
  2460.           Search for text fragments only, i.e. the Amiga patterns like
  2461.           e.g.  `#?' are not used.
  2462.  
  2463.         * ALL
  2464.  
  2465.           All fields are searched.
  2466.  
  2467.         * SALUTATION
  2468.  
  2469.           Only the `Salutation' fields are searched.
  2470.  
  2471.         * FIRST
  2472.  
  2473.           Only the `First' fields are searched.
  2474.  
  2475.         * NAME
  2476.  
  2477.           Only the `Name' fields are searched.
  2478.  
  2479.         * STREET
  2480.  
  2481.           Only the `Street' fields are searched.
  2482.  
  2483.         * CO
  2484.  
  2485.           Only the `c/o' fields are searched.
  2486.  
  2487.         * ZIP
  2488.  
  2489.           Only the `ZIP' fields are searched.
  2490.  
  2491.         * CITY
  2492.  
  2493.           Only the `City' fields are searched.
  2494.  
  2495.         * STATE
  2496.  
  2497.           Only the `State' fields are searched.
  2498.  
  2499.         * COUNTRY
  2500.  
  2501.           Only the `Country' fields are searched.
  2502.  
  2503.         * BIRTHDAY
  2504.  
  2505.           Only the `Birthday' fields are searched.
  2506.  
  2507.         * PHONE
  2508.  
  2509.           Only the `Phone' fields are searched.
  2510.  
  2511.         * FAX
  2512.  
  2513.           Only the `Fax' fields are searched.
  2514.  
  2515.         * EMAIL1
  2516.  
  2517.           Only the `EMail1' fields are searched.
  2518.  
  2519.         * EMAIL2
  2520.  
  2521.           Only the `EMail2' fields are searched.
  2522.  
  2523.         * EMAIL3
  2524.  
  2525.           Only the `EMail3' fields are searched.
  2526.  
  2527.         * COMMENT
  2528.  
  2529.           Only the `Comment' fields are searched.
  2530.  
  2531.         * VAR <name>
  2532.  
  2533.         * STEM <name>
  2534.  
  2535. `Results:'
  2536.         * .ADDRESS.COUNT
  2537.  
  2538.         * .ADDRESS.x
  2539.  
  2540.      The following error codes can be returned in `RC2':
  2541.  
  2542.         * RXERR_ENVCHANGED
  2543.  
  2544.         * RXERR_NOTFOUND
  2545.  
  2546. `Example:'
  2547.  
  2548.           /*
  2549.            * Look for all names beginning with `M'.
  2550.            * Make no difference between upper and lower case.
  2551.            */
  2552.           
  2553.           ADDRESS 'DFA'
  2554.           
  2555.           SEARCH 'M#?' IGNORECASE NAME
  2556.  
  2557. The SEARCHNEXT Command
  2558. ......................
  2559.  
  2560. `Syntax:'
  2561.      SEARCHNEXT [VAR <name>] [STEM <name>]
  2562.  
  2563. `Argument template:'
  2564.      VAR/K, STEM/K
  2565.  
  2566. `Function:'
  2567.      Continue searching for the pattern given before in `SEARCH'.  If
  2568.      the search succeeded, the found address is returned. If the
  2569.      *DFA-Editor* is currently running, the address listview is updated.
  2570.  
  2571. `Argument description:'
  2572.         * VAR <name>
  2573.  
  2574.         * STEM <name>
  2575.  
  2576. `Results:'
  2577.         * .ADDRESS.COUNT
  2578.  
  2579.         * .ADDRESS.x
  2580.  
  2581. `Note:'
  2582.      The following error codes can be returned in `RC2':
  2583.  
  2584.         * RXERR_NOTFOUND
  2585.  
  2586.         * RXERR_ENVCHANGED
  2587.  
  2588. The SELALL Command
  2589. ..................
  2590.  
  2591. `Syntax:'
  2592.      SELALL
  2593.  
  2594. `Function:'
  2595.      All addresses are selected.
  2596.  
  2597. `Results:'
  2598.      The following error codes can be returned in `RC2':
  2599.  
  2600.         * RXERR_ENVCHANGED
  2601.  
  2602.         * RXERR_NONETWORKSELECT
  2603.  
  2604. `Note:'
  2605.      Only addresses that match the current group selection are selected.
  2606.  
  2607. The SELBYNAME Command
  2608. .....................
  2609.  
  2610. `Syntax:'
  2611.      SELBYNAME [PATTERN] <string>
  2612.  
  2613. `Argument template:'
  2614.      PATTERN/A
  2615.  
  2616. `Function:'
  2617.      All addresses that match the given pattern are selected. Upper and
  2618.      lower case does not make a difference.
  2619.  
  2620. `Argument description:'
  2621.         * PATTERN <string>
  2622.  
  2623.           A pattern string. The description of such patterns can be
  2624.           found in EditorSearch.
  2625.  
  2626. `Results:'
  2627.      The following error codes can be returned in `RC2':
  2628.  
  2629.         * RXERR_ENVCHANGED
  2630.  
  2631.         * RXERR_NONETWORKSELECT
  2632.  
  2633. `Note:'
  2634.      All fields of all addresses (that match the current group
  2635.      selection) are searched.
  2636.  
  2637. The SELECT Command
  2638. ..................
  2639.  
  2640. `Syntax:'
  2641.      SELECT [QUERY] [VAR <name>] [STEM <name>]
  2642.  
  2643. `Argument template:'
  2644.      QUERY/S, VAR/K, STEM/K
  2645.  
  2646. `Function:'
  2647.      The current entry (if there is one) is selected. If you supply the
  2648.      `QUERY' parameter, the current address is *not* selected, but its
  2649.      selection state (`0' or `1') is returned.
  2650.  
  2651. `Argument description:'
  2652.         * QUERY
  2653.  
  2654.         * VAR <name>
  2655.  
  2656.         * STEM <name>
  2657.  
  2658. `Results:'
  2659.         * .SELECTED
  2660.  
  2661.      The following error codes can be returned in `RC2':
  2662.  
  2663.         * RXERR_NOCURRENT
  2664.  
  2665.         * RXERR_ENVCHANGED
  2666.  
  2667.         * RXERR_NONETWORKSELECT
  2668.  
  2669. The SETPREFS Command
  2670. ....................
  2671.  
  2672. `Syntax:'
  2673.      SETPREFS [<showappicon|appicon>] [AUTOSAVE|AS <string>]
  2674.      [<makeicon>] [<secretmode|sm>] [<networkmode|nwmode>]
  2675.      [NETWORKRETRIES|NWRETRIES <figure>] [NETWORKDELAY|NWDELAY
  2676.      <figure>] [GROUPNAME1 <string>] [GROUPNAME2 <string>] [GROUPNAME3
  2677.      <string>] [GROUPNAME4 <string>] [GROUPNAME5 <string>] [GROUPNAME6
  2678.      <string>] [GROUPNAME7 <string>] [GROUPNAME8 <string>]
  2679.      [GROUPRELATION|GREL <string>] [MODEMBAUD|MBAUD <string>]
  2680.      [MODEMINIT|MINIT <string>] [MODEMEXIT|MEXIT <string>]
  2681.      [MODEMPREDIAL|MPDIAL <string>] [MODEMSUFFDIAL|MSDIAL <string>]
  2682.      [MODEMSERDEV|MDEV <string>] [MODEMSERDEVNO|MDEVNO <figure>]
  2683.      [<modemuseodu|modu>] [MODEMRETRIES|MRETRIES <figure>]
  2684.      [MODEMDELAY|MDELAY <figure>] [PATHSADDRESSFILE|PAFILE <string>]
  2685.      [PATHSEXTERNALDIR|PEXT <string>] [PATHSASCIIED|PASCIIED <string>]
  2686.      [PATHSASCIISHOW|PASCIISHOW <string>] [SORTBY1 <string>] [SORTBY2
  2687.      <string>] [SORTBY3 <string>] [SORTBY4 <string>]
  2688.  
  2689. `Argument template:'
  2690.      SHOWAPPICON=APPICON/T, AUTOSAVE=AS/K, MAKEICON/T, SECRETMODE=SM/T,
  2691.      NETWORKMODE=NWMODE/T, NETWORKRETRIES=NWRETRIES/K/N,
  2692.      NETWORKDELAY=NWDELAY/K/N, GROUPNAME1/K, GROUPNAME2/K,
  2693.      GROUPNAME3/K, GROUPNAME4/K, GROUPNAME5/K, GROUPNAME6/K,
  2694.      GROUPNAME7/K, GROUPNAME8/K, GROUPRELATION=GREL/K,
  2695.      MODEMBAUD=MBAUD/K, MODEMINIT=MINIT/K, MODEMEXIT=MEXIT/K,
  2696.      MODEMPREDIAL=MPDIAL/K, MODEMSUFFDIAL=MSDIAL/K, MODEMSERDEV=MDEV/K,
  2697.      MODEMSERDEVNO=MDEVNO/K/N, MODEMUSEODU=MODU/T,
  2698.      MODEMRETRIES=MRETRIES/K/N, MODEMDELAY=MDELAY/K/N,
  2699.      PATHSADDRESSFILE=PAFILE/K, PATHSEXTERNALDIR=PEXT/K,
  2700.      PATHSASCIIED=PASCIIED/K, PATHSASCIISHOW=PASCIISHOW/K, SORTBY1/K,
  2701.      SORTBY2/K, SORTBY3/K, SORTBY4/K
  2702.  
  2703. `Function:'
  2704.      Lets you set the most important settings.
  2705.  
  2706. `Argument description:'
  2707.         * SHOWAPPICON|APPICON
  2708.  
  2709.           Switches the application icon on or off.
  2710.  
  2711.         * AUTOSAVE|AS <string>
  2712.  
  2713.           Selects the desired save mode, i.e. one of:
  2714.  
  2715.              - ALWAYS The address file is saved *always*, if you leave
  2716.                the *DFA-Editor*.
  2717.  
  2718.              - REMOVE The address file is saved only if you *remove*
  2719.                *DFA*, i.e.  the *DFA-Server* is terminated as well.
  2720.                wird.
  2721.  
  2722.              - ASK If you leave the *DFA-Editor*, you're asked if you
  2723.                want to save the address file.
  2724.  
  2725.         * MAKEICON
  2726.  
  2727.           If you switch this on, an icon is created for every address
  2728.           file you save.
  2729.  
  2730.         * SECRETMODE|SM
  2731.  
  2732.           Toggles the "secret" mode on or off.
  2733.  
  2734.         * NETWORKMODE|NWMODE
  2735.  
  2736.           Switches the network mode on or off.
  2737.  
  2738.         * NETWORKRETRIES|NWRETRIES <figure>
  2739.  
  2740.           Number of retries for the network mode.
  2741.  
  2742.         * NETWORKDELAY|NWDELAY <figure>
  2743.  
  2744.           Delay between two retries (in seconds).
  2745.  
  2746.         * GROUPNAME1
  2747.  
  2748.         * GROUPNAME2
  2749.  
  2750.         * GROUPNAME3
  2751.  
  2752.         * GROUPNAME4
  2753.  
  2754.         * GROUPNAME5
  2755.  
  2756.         * GROUPNAME6
  2757.  
  2758.         * GROUPNAME7
  2759.  
  2760.         * GROUPNAME8
  2761.  
  2762.           The name of the different groups.
  2763.  
  2764.         * GROUPRELATION|GREL <string>
  2765.  
  2766.           The kind of relation between the groups, i.e. `OR' or `AND'.
  2767.  
  2768.         * MODEMBAUD|MBAUD <figure>
  2769.  
  2770.           Baud rate; available are:
  2771.  
  2772.           1200, 2400, 4800, 7200, 9600, 12000, 14400, 16800, 19200,
  2773.           31250, 38400, 57600, 64000, 76800 and 115200 baud.
  2774.  
  2775.         * MODEMINIT|MINIT <string>
  2776.  
  2777.           String to initialize the modem.
  2778.  
  2779.         * MODEMEXIT|MEXIT <string>
  2780.  
  2781.           String to terminate a connection.
  2782.  
  2783.         * MODEMPREDIAL|MPDIAL <string>
  2784.  
  2785.           String to send just before the phone number.
  2786.  
  2787.         * MODEMSUFFDIAL|MSDIAL <string>
  2788.  
  2789.           String to send just behind the phone number.
  2790.  
  2791.         * MODEMSERDEV|MDEV <string>
  2792.  
  2793.           Name of the serial device.
  2794.  
  2795.         * MODEMSERDEVNO|MDEVNO <figure>
  2796.  
  2797.           Unit of the serial device.
  2798.  
  2799.         * MODEMUSEODU|MODU
  2800.  
  2801.           Usage of the `OwnDevUnit.library'.
  2802.  
  2803.         * MODEMRETRIES|MRETRIES <figure>
  2804.  
  2805.           Number of retries used for dialing.
  2806.  
  2807.         * MODEMDELAY|MDELAY <figure>
  2808.  
  2809.           Delay between two retries.
  2810.  
  2811.         * PATHSADDRESSFILE|PAFILE <string>
  2812.  
  2813.           Name of the address file to load during startup.
  2814.  
  2815.         * PATHSEXTERNALDIR|PEXT <string>
  2816.  
  2817.           Name of the drawer to store the external files in.
  2818.  
  2819.         * PATHSASCIIED|PASCIIED <string>
  2820.  
  2821.           Name of the editor (incl. its path), which is to be used for
  2822.           the external files.
  2823.  
  2824.         * PATHSASCIISHOW|PASCIISHOW <string>
  2825.  
  2826.           Name of the viewer (incl. its path), which is to be used for
  2827.           the external files.
  2828.  
  2829.         * SORTBY1 <string>
  2830.  
  2831.         * SORTBY2 <string>
  2832.  
  2833.         * SORTBY3 <string>
  2834.  
  2835.         * SORTBY4 <string> Every sort criteria can get one of the
  2836.           following field names:
  2837.  
  2838.           `SALUTATION', `FIRSTNAME', `NAME', `CO', `STREET', `ZIP',
  2839.           `CITY', `STATE', `COUNTRY', `BIRTHDAY', `PHONE', `FAX',
  2840.           `EMAIL1', `EMAIL2', `EMAIL3', `COMMENT'.
  2841.  
  2842.           If you want to delete a sort criteria, just give `CLEAR'
  2843.           instead of a field name.
  2844.  
  2845. `Results:'
  2846.      -
  2847.  
  2848. The SORT Command
  2849. ................
  2850.  
  2851. `Syntax:'
  2852.      SORT [SORT1 <string>] [SORT2 <string>] [SORT3 <string>] [SORT4
  2853.      <string>]
  2854.  
  2855. `Argument template:'
  2856.      SORT1/K, SORT2/K, SORT3/K, SORT4/K
  2857.  
  2858. `Function:'
  2859.      The addresses are sorted according to the sort criteria given in
  2860.      the *DFA-Preferences*. Alternatively you may explicitly give the
  2861.      search criteria by which you would like your addresses be sorted.
  2862.  
  2863. `Argument description:'
  2864.         * SORT1 <string>
  2865.  
  2866.         * SORT2 <string>
  2867.  
  2868.         * SORT3 <string>
  2869.  
  2870.         * SORT4 <string>
  2871.  
  2872.           The following keywords are supported for the `Sort'
  2873.           parameters:
  2874.  
  2875.              - SALUTATION
  2876.  
  2877.              - FIRST
  2878.  
  2879.              - NAME
  2880.  
  2881.              - CO
  2882.  
  2883.              - STREET
  2884.  
  2885.              - ZIP
  2886.  
  2887.              - CITY
  2888.  
  2889.              - STATE
  2890.  
  2891.              - COUNTRY
  2892.  
  2893.              - BIRTHDAY
  2894.  
  2895.              - PHONE
  2896.  
  2897.              - FAX
  2898.  
  2899.              - EMAIL1
  2900.  
  2901.              - EMAIL2
  2902.  
  2903.              - EMAIL3
  2904.  
  2905.              - COMMENT
  2906.  
  2907. `Results:'
  2908.      The following error codes can be returned in `RC2':
  2909.  
  2910.         * RXERR_ENVCHANGED
  2911.  
  2912.         * RXERR_NONETWORKSORT
  2913.  
  2914. Error Codes
  2915. -----------
  2916.  
  2917. Below the usual error code that can be found in the `RC' variable (1)
  2918. the AREXX interface of DFA returns a second return value in the
  2919. variable `RC2', which describes in further detail what has gone wrong.
  2920.  
  2921. Bolow you'll find the error numbers and their meaning:
  2922.  
  2923.  
  2924.          *Symbolic Name*                *Meaning*
  2925.      
  2926.      10  RXERR_NONETWORKAPPEND....Could not append file,
  2927.                                   as the network mode is activated
  2928.      11  RXERR_MODIFIED...........The address file has been changed
  2929.      12  RXERR_NOFILENAME.........No filename has been supplied
  2930.      13  RXERR_NOCURRENT..........No current address available
  2931.      14  RXERR_NOFIRST............No first address available
  2932.      15  RXERR_NOICONIFY..........Iconifying the Editor went wrong
  2933.      16  RXERR_NONETWORKKILL......Deleting addresses is not allowed
  2934.                                   while in network mode
  2935.      17  RXERR_NOLAST.............There is no last address
  2936.      18  RXERR_NOLOAD.............The address file could not be loaded
  2937.      19  RXERR_NONETWORKNEW.......It is not possible to enter new
  2938.                                   addresses in network mode
  2939.      20  RXERR_NONEXT.............There is no next address
  2940.      21  RXERR_NONEXTSEL..........There is no next selected address
  2941.      22  RXERR_NOPREV.............There is no previous address
  2942.      23  RXERR_NOPREVSEL..........There is no previous selected address
  2943.      24  RXERR_SYNTAX.............The AREXX command contained an syntax error
  2944.      25  RXERR_WRITEALL...........The "printing" of addresses (all)
  2945.                                   into a file went wrong
  2946.      26  RXERR_WRITESEL...........The "printing" of addresses (selected)
  2947.                                   into a file went wrong
  2948.      27  RXERR_WRITECURRENT.......The "printing" of the current address
  2949.                                   into a file went wrong
  2950.      28  RXERR_NOSAVE.............The address file could not be saved
  2951.      29  RXERR_NONETWORKSAVE......Saving your address database is not
  2952.                                   allowed in network mode
  2953.      30  RXERR_NOTFOUND...........The wanted address could not be found
  2954.      31  RXERR_NONETWORKCLEAR.....Unselecting addresses is not allowed
  2955.                                   while being in network mode
  2956.      32  RXERR_NONETWORKSELECT....Selecting addresses is not allowed
  2957.                                   in network mode
  2958.      33  RXERR_NONETWORKSORT......Sorting addresses is not allowed
  2959.                                   while being in network mode
  2960.      34  RXERR_NONETWORKEDIT......Editing addresses is not allowed
  2961.                                   while being in network mode
  2962.      35  RXERR_OPNPRT.............Could not open printer device
  2963.      36  RXERR_CRTEXTIO...........Could not reach the printer
  2964.                                   (ExtIO could not be initialized)
  2965.      37  RXERR_CRTPORT............Could not reach the printer
  2966.                                   (Could not open message port)
  2967.      38  RXERR_NOMEM..............No more RAM available
  2968.      39  RXERR_NORELOAD...........Reloading the address file went wrong
  2969.      40  RXERR_NOWRITELOCK........could not get write access to the
  2970.                                   address file
  2971.      41  RXERR_NODIR..............Could not locate the needed drawer
  2972.      42  RXERR_NOFILE.............Could not find the address file
  2973.      43  RXERR_APPENDFAILED.......Appending an address file went wrong
  2974.      44  RXERR_ENVCHANGED.........Execution of the current AREXX command
  2975.                                   has been canceled, as the environment changed
  2976.                                   (e.g. new address file)
  2977.      45  RXERR_NOEXTERNAL.........Trying to access the external file had no success
  2978.      46  RXERR_NOSERIALDEV........Could not open serial device
  2979.      47  RXERR_NOPHONENUM.........Current address doesn't have a phone number
  2980.      48  RXERR_SERNOCARRIER.......Phone: No Carrier
  2981.      49  RXERR_SERNODIALTONE......Phone: No dialtone
  2982.      50  RXERR_SERRING............Phone: Ring
  2983.      51  RXERR_SERBUSY............Phone: Line is busy
  2984.      52  RXERR_SEROK..............Phone: Modem sent 'Ok'
  2985.      53  RXERR_SERERROR...........Phone: Modem recognized an error
  2986.      54  RXERR_SERCONNECT.........Phone: Data connect
  2987.      55  RXERR_SERVOICE...........Phone: Voice connect
  2988.      56  RXERR_SERUNKNOWN.........Error caused by the serial device
  2989.      57  RXERR_OPNPRFS............The preferences file could not be
  2990.                                   opened
  2991.  
  2992. ---------- Footnotes ----------
  2993.  
  2994. (1)  cf. AREXX User's Reference Manual, William S. Hawes, P.O. Box 308,
  2995. Maynard, MA 01754
  2996.  
  2997. The DFA-Editor program
  2998. **********************
  2999.  
  3000. The *DFA-Editor* is the graphical user interface of *DFA*.
  3001.  
  3002. It can be started seperately or may be invoked (by the hotkey for
  3003. example) out of the *DFA-Server*.
  3004.  
  3005. Tooltypes
  3006. =========
  3007.  
  3008. If you click once on the *DFA-Editor* icon and then activate the
  3009. Information program of the Workbench, you may adjust the following
  3010. tooltypes:
  3011.  
  3012.    * *`PUBSCREEN'*
  3013.  
  3014.      If you enter the *name* of a public screen together with this
  3015.      tooltype, you may select an alternate (public) screen for the
  3016.      *DFA-Editor* to open on.
  3017.  
  3018.      For example:
  3019.  
  3020.  
  3021.               PUBSCREEN=TERM
  3022.  
  3023.      If the given public screen exists when the *DFA-Editor* comes up,
  3024.      it opens its window(s) on this screen, otherwise on the default
  3025.      public screen, usually the Workbench screen.
  3026.  
  3027.    * *`UPPERPUBSCREEN'*
  3028.  
  3029.      If you enter `UPPERPUBSCREEN=YES', you tell the *DFA-Editor* to
  3030.      open its window(s) on the frontmost *public* screen. If the
  3031.      current frontmost screen isn't public, the *DFA-Editor* comes up
  3032.      on the screen you selected with the tooltype `PUBSCREEN'; if this
  3033.      fails as well, the *DFA-Editor* opens its window(s) on the default
  3034.      public screen.
  3035.  
  3036.    * *`GUIDEFILE'*
  3037.  
  3038.      To make the online help work, the *DFA-Editor* has to know where
  3039.      to find the online help file. This can be done via the tooltype
  3040.      `GUIDEFILE'. This tooltype is usually already set by the install
  3041.      program.
  3042.  
  3043.    * *`DFAPREFS'*
  3044.  
  3045.      As the *DFA-Preferences* program can be started directly out of
  3046.      the *DFA-Editor*, the *DFA-Editor* has to know where to find the
  3047.      *DFA-Preferences* program. The complete path name must be given
  3048.      with the tooltype `DFAPREFS' and is already set by the install
  3049.      program usually.
  3050.  
  3051. CLI Parameter
  3052. =============
  3053.  
  3054. If you start the *DFA-Editor* from the shell (or the CLI), it uses the
  3055. *tooltypes* of the corresponding `.info' file!  However, you may
  3056. overwrite these settings by giving one or more of the following CLI
  3057. parameters:
  3058.  
  3059.  
  3060.      PUBSCREEN/K,UPPERPUBSCREEN/K,GUIDEFILE/K,DFAPREFS/K
  3061.  
  3062. This means, you may use...
  3063.  
  3064.    ... `DFAEditor PUBSCREEN=TERM' to make the *DFA-Editor* open its
  3065.      window(s) on the public screen named `TERM'.
  3066.  
  3067.    ... `DFAEditor UPPERPUBSCREEN=YES' to make the *DFA-Editor* open its
  3068.      window(s) on the frontmost screen, as long as this is a public
  3069.      screen.
  3070.  
  3071.    ... `DFAEditor GUIDEFILE=Help:DFAEditor.guide' to set another path
  3072.      for the online help file.
  3073.  
  3074.    ... `DFAEditor DFAPREFS=C:DFAPrefs' to set another path for the call
  3075.      of the *DFA-Preferences* program.
  3076.  
  3077. The Main Window
  3078. ===============
  3079.  
  3080. The main window of the *DFA-Editor* can be resized using the sizing
  3081. gadget on the lower right corner of the window. The window contents
  3082. automatically adapts to the new window dimensions.
  3083.  
  3084. As the main window is a socalled application window, you may drag the
  3085. icon of an address file on this window and drop it to let the
  3086. *DFA-Editor* load the corresponding address file.
  3087.  
  3088. The main window of the *DFA-Editor* gives you the following
  3089. possibilities:
  3090.  
  3091.    * *The address listview*
  3092.  
  3093.      The address listview displays the stored addresses that are
  3094.      available as soon as you entered some (more details about this
  3095.      subject later on).  You can control this listview completely by
  3096.      mouse or by keyboard:
  3097.  
  3098.  
  3099.              Cursor down     The next address becomes the current one.
  3100.           
  3101.           SHIFT+Cursor down  The list scrolls *up* by one page.
  3102.           
  3103.           CRTL+Cursor down   The last address becomes the current one.
  3104.           
  3105.               Cursor up      The previous address becomes the current one.
  3106.           
  3107.            SHIFT+Cursor up   The list scrolls *down* by one page.
  3108.           
  3109.            CRTL+Cursor up    The first address becomes the current one.
  3110.           
  3111.                              The current entry is selected.
  3112.                SPACE         To make this state visible, the current entry
  3113.                              is leaded by a `>' character.
  3114.           
  3115.                RETURN        Activates the `Full' window, as long as
  3116.                              there is an active address item.
  3117.           
  3118.             SHIFT+RETURN     Activates the `Edit' window, as long as
  3119.                              there is an active address item.
  3120.           
  3121.             SHIFT+SPACE      Set the start of the block or the end of the
  3122.                              block respectively
  3123.           
  3124.             RSHIFT+[a-z]     *Quick--Search:*
  3125.                              Right-Shift together with a letter activate
  3126.                              the first address starting with this letter
  3127.  
  3128.      You may select entries of the address list with `Shift Left
  3129.      Mousebutton' or `Middle Mousebutton Left Mousebutton' (3-Button
  3130.      mouse needed); alternatively you may hit `SPACE' on the keyboard.
  3131.      If you hit `RETURN', it has the same effect as if you had selected
  3132.      the `Full' button: The current address is displayed in another
  3133.      window in further detail (please see EditorFull for details).
  3134.      Synonymously you may hit `SHIFT RETURN' to envoce the `Edit'
  3135.      window (see EditorEdit).
  3136.  
  3137.      `SHIFT SPACE' sets the start and end of the block.  After the
  3138.      block end is set, the selection state of all items between start
  3139.      end end of the block is toggled, i.e.  the selected addresses
  3140.      become deselected and vice versa.  The same result can be reached
  3141.      if you use the left mouse button together with the `SHIFT'
  3142.      qualifier.
  3143.  
  3144.      The *Quick Search* function gives you a mean to navigate to the
  3145.      near of the desired address quickly. *DFA* always looks for the
  3146.      1st sort criteria; therefore, your address must be sorted to make
  3147.      the *Quick Search* function work correctly.
  3148.  
  3149.      Please notice that you may change the fields of the addresses that
  3150.      are displayed in the address listview using the *DFA-Preferences*
  3151.      program.
  3152.  
  3153.    * *The Panel Listview*
  3154.  
  3155.      Below the address listview you find another listview. It is used to
  3156.      display some more fields of the current address item. If you use
  3157.      the default settings, you'll see the phone number, the three email
  3158.      addresses and the comment. However, by using the *DFA-Preferences*
  3159.      program you may change the contents of these lines!
  3160.  
  3161.      As this listview doesn't have a title and for this reason no
  3162.      shortcut either, you may scroll it using the following keys:
  3163.  
  3164.  
  3165.           ALT+Cursor down  The list scrolls *up* by one line.
  3166.  
  3167.           ALT+Cursor up   The list scrolls *down* by one line.
  3168.  
  3169.      Of course, the list can only be scrolled if there is 1st an active
  3170.      entry and 2nd more lines to display than visible at the same time.
  3171.  
  3172.      The contents of this listview can be configured in quite a wide
  3173.      range (see *DFA-Preferences*: Panel Listview, for details).
  3174.  
  3175.    * *Selection of Addresses*
  3176.  
  3177.      Just below the the address listview, there are four buttons that
  3178.      may be used to change the selection of the displayed addresses:
  3179.  
  3180.         * *All*
  3181.  
  3182.           Selects all displayed addresses.
  3183.  
  3184.         * *By name*
  3185.  
  3186.           A window is opened in which you may enter a search pattern
  3187.           (case insensitive!). After you hit `Ok' (or `RETURN') all
  3188.           entries of the address list are selected that match the
  3189.           pattern. The difference to the `Search' function is that 1st
  3190.           you can't toggle case sensitivity and 2nd all address fields
  3191.           are searched through.  Furthermore, all matching items are
  3192.           *marked*, and the first matching item is activated. A
  3193.           detailed description of the allowed search patterns can be
  3194.           found in EditorSearch.
  3195.  
  3196.         * *Clear*
  3197.  
  3198.           All selected addresses are deselected.
  3199.  
  3200.         * *Jump to*
  3201.  
  3202.           The next selected entry becomes the current one, as long as
  3203.           there is at least one selected entry left.
  3204.  
  3205.    * *AREXX Scripts*
  3206.  
  3207.      In addition to the possibility to reach the AREXX scripts by the
  3208.      menu items (EditorMenuArexxCommands), you may also reach them by
  3209.      the function keys `f1' to `f10' or `SHIFT F1' to `SHIFT F10'
  3210.      respectively.
  3211.  
  3212. At the lower end of the main window of the *DFA-Editor* you can find
  3213. the gadgets `Quit' and `Remove'.
  3214.  
  3215. If you hit `Quit', the *DFA-Editor* is terminated! The *DFA-Server*, if
  3216. it is currently running, is not ended however, so you can still reach
  3217. the *DFA-Editor* by a doubleclick on the application icon and/or the
  3218. hotkey (default: `Left Amiga F5')
  3219.  
  3220. If you select `Remove', not only the *DFA-Editor* is ended, but also
  3221. any currently running *DFA-Server*.
  3222.  
  3223. If you terminate the *DFA-Editor* using `Quit' or `Remove', the
  3224. addresses are saved if they had been modified before.  This behaviour
  3225. can be customized in the *DFA-Preferences* however.
  3226.  
  3227. Tool Gadgets
  3228. ============
  3229.  
  3230. It is possible reach the so called tool gadgets from the *DFA-Editor*.
  3231. Using these gadgets, you can easily reach the following functions :
  3232.  
  3233.    * *Full*
  3234.  
  3235.      Shows the current entry in another window in great detail; see
  3236.      EditorFull for details.
  3237.  
  3238.    * *Edit*
  3239.  
  3240.      If you hit `Edit', you may change the current entry. If there is
  3241.      no current address, this button is "ghosted" and can't be selected
  3242.      (cf. EditorEdit).
  3243.  
  3244.    * *New*
  3245.  
  3246.      If you select `New', you may enter a *new* address. The functions
  3247.      within this window are nearly the same as within the `Edit'
  3248.      window; see EditorNew for details.
  3249.  
  3250.    * *Kill*
  3251.  
  3252.      Kill can either be used to delete the current entry (if there is
  3253.      one) or all marked entries. To make sure that nobody deletes
  3254.      precious addresses, a safety requester pops up!
  3255.  
  3256.    * *Search*
  3257.  
  3258.      Another window pops up in which you may enter a search string, as
  3259.      well as some other search related settings (cf. EditorSearch).
  3260.  
  3261.    * *Search Next*
  3262.  
  3263.      `Search Next' can be selected only if there has been given a
  3264.      search pattern previously using the `Search' function. If this is
  3265.      the case, the next matching entry is displayed (not marked!).
  3266.  
  3267.    * *Print*
  3268.  
  3269.      After you have selected `Print', another window pops up which
  3270.      gives you several ways to print your addresses, as it is described
  3271.      in EditorPrint.
  3272.  
  3273.    * *Sort*
  3274.  
  3275.      `Sort' sorts the complete address list. As long as you use the
  3276.      default setting, the list is sorted by name, first name and city
  3277.      (in this order). If you prefer another sort order, you may change
  3278.      it in the *DFA-Preferences*.
  3279.  
  3280.    * *Dial*
  3281.  
  3282.      Another window pops up, which allows you to dial phone numbers (cf.
  3283.      EditorDial).
  3284.  
  3285. Please notice that there is a corresponding menu item for every tool
  3286. gadget. All functions can, therefore, be reached by keyboard shortcuts
  3287. as well!
  3288.  
  3289. The Menu Items
  3290. ==============
  3291.  
  3292. About
  3293. -----
  3294.  
  3295. The `About' window gives you some useful information about the program
  3296. and the author:
  3297.  
  3298.    * The version number and a corresponding remark, if you got a
  3299.      registered version.
  3300.  
  3301.    * The copyright notice and the author's address (incl. email
  3302.      addresses).
  3303.  
  3304.    * Your name and your address, as well as the serial number of the
  3305.      program, if you are a registered user.
  3306.  
  3307. Info
  3308. ----
  3309.  
  3310. The window which pops up as soon as you select the `Info' menu item,
  3311. gives you some useful information:
  3312.  
  3313.    * *Arexx Port*
  3314.  
  3315.      In this field you can look up the name of `DFA''s AREXX port.
  3316.      Usually this is `DFA'. However, you can change the portname by
  3317.      changing the `PORTNAME' tooltype (of the *DFA* server program!)
  3318.  
  3319.      If you have already started a program that uses the portname
  3320.      `DFA', `DFA' adapts the portname by appending "numbers" (e.g.
  3321.      `DFA.1', `DFA.2',...) until a clear portname is found.
  3322.  
  3323.    * *Addresses*
  3324.  
  3325.      The number of the currently loaded address is displayed here. The
  3326.      first number (`d' means displayed)  is the number of actually
  3327.      displayed entries, the second number (`a' means available) is the
  3328.      number of addresses available.
  3329.  
  3330.    * *Memory Condition*
  3331.  
  3332.      The three fields give a detailed report about the current memory
  3333.      condition.
  3334.  
  3335. New file
  3336. --------
  3337.  
  3338. If you want to create a *new*, i.e. *empty* address file, you use this
  3339. menu item. A new address file named unnamed.dfa is created. You may use
  3340. the `Save as...' menu item to save this address file under another name.
  3341.  
  3342. *Be careful:*
  3343.  
  3344. Please, never use `Save as default' after you created a new file to
  3345. save it, as the new address file (the empty one!) would overwrite your
  3346. old "default" address file, which means that the old addresses would
  3347. have been lost!
  3348.  
  3349.  
  3350. Open
  3351. ----
  3352.  
  3353. Use `Open' to load another address file. The currently loaded addresses
  3354. are not kept in memory but replaced by the loaded! After you selected
  3355. `Load', a file requester pops up, which lets you enter the address
  3356. file. Notice that only files with the proper format can be loaded --
  3357. files that have been created by *DFA* before!  Files with the wrong
  3358. format can't be loaded by `DFA' and the addresses in RAM are kept
  3359. unchanged!
  3360.  
  3361. Append
  3362. ------
  3363.  
  3364. `Append' allows you to append further addresses to the existing ones.
  3365. The addresses in RAM are *not* deleted before. Be careful! If you
  3366. append two identical address lists, every entry will appear twice,
  3367. which is usually not desired.
  3368.  
  3369. It is possible to set the group selection for the addresses that are to
  3370. be appended in the little window that appears after you selected
  3371. `Append'. These group selection flags are set to all addresses that
  3372. shall be loaded!
  3373.  
  3374. Please notice that existing group flags of addresses in the file to
  3375. append are *not* erased! This means that you may only add new group
  3376. flags to the addresses but not unset existing ones!
  3377.  
  3378. `Ok' accepts the set group selection and appends the selected address
  3379. file; `Cancel' not only cancels the group selection, but the complete
  3380. appending procedure, i.e. no addresses are appended!
  3381.  
  3382. Save
  3383. ----
  3384.  
  3385. `Save' saves the addresses with the current name. The current name is
  3386. either the one you entered in the preferences (default:
  3387. `DFA:Addressfiles/Default.dfa') or the one you selected before when
  3388. loading an address file.
  3389.  
  3390. Save as...
  3391. ----------
  3392.  
  3393. `Save as' saves the address as well. However, you are able to select a
  3394. filename before (a file requester pops up). This may be useful if you
  3395. have several address files for different purposes, or you've created a
  3396. new address file just before (cf.  EditorMenuNewFile) and want to enter
  3397. a new name for your address file.
  3398.  
  3399. Save as default
  3400. ---------------
  3401.  
  3402. The addresses will be saved with the name specified in the preferences
  3403. (default: `s:adr.file'), if you select `Save as default', even if you
  3404. loaded a file with another name before.
  3405.  
  3406. *Be careful:*
  3407.  
  3408. If you have loaded an address file with other than the default name
  3409. before (or you've created a new address file), you should not use
  3410. `Save as default', as the current address file would overwrite the
  3411. default address file.
  3412.  
  3413.  
  3414. Quit
  3415. ----
  3416.  
  3417. `Quit' ends the *DFA-Editor*! The *DFA-Server*, if it is currently
  3418. running, is not ended, so the *DFA-Editor* still can be reached by a
  3419. double click on the application icon or by the hotkey (Default: `Left
  3420. Amiga F5').
  3421.  
  3422. Remove
  3423. ------
  3424.  
  3425. Select `Remove' to end not only the *DFA-Editor* but a currently running
  3426. *DFA-Server* as well.
  3427.  
  3428. If you end the *DFA-Editor* using `Quit' or `Remove DFA', the addresses
  3429. are saved if they have been modified. This behaviour can be customized
  3430. in the *DFA-Preferences* program however.
  3431.  
  3432. Full
  3433. ----
  3434.  
  3435. Shows the current entry in a separate window. *All* fields of the
  3436. address are displayed here; See EditorFull.
  3437.  
  3438. Edit
  3439. ----
  3440.  
  3441. Using `Edit' gives you the chance to change the current address item,
  3442. if there is one. If there is no current entry, the corresponding button
  3443. is "ghosted" and can't be selected (see EditorEdit).
  3444.  
  3445. New
  3446. ---
  3447.  
  3448. Select `New' to enter a *new* address. The functions inside of this
  3449. window are exactly the same as within the `Edit' window; see EditorNew
  3450. for details.
  3451.  
  3452. Kill
  3453. ----
  3454.  
  3455. Use `Kill' to delete either the current entry (if there is one) or all
  3456. marked addresses. To make sure that nobody deletes precious addresses,
  3457. a savety requester pops up.
  3458.  
  3459. Copy to Clipboard
  3460. -----------------
  3461.  
  3462. This function makes it possible to copy the *current* address to the
  3463. clipboard (unit 0).
  3464.  
  3465. Every other program that supplies clipboard support, can access these
  3466. data.
  3467.  
  3468. Set and Unset Groups
  3469. --------------------
  3470.  
  3471. After you have selected this menu item, another window pops up that
  3472. allows you to change the group flags of one, several or all addresses
  3473. fast and comfortably.
  3474.  
  3475. Any of the 8 cycle gadgets takes effect to the corresponding group
  3476. flag. You may either keep, set or clear each flag.
  3477.  
  3478. Please notice that these actions take effect only to the active
  3479. addresses, i.e. the addresses that can be seen within the main address
  3480. listview.
  3481.  
  3482. Hit `Active' to change the current address (if there exists one),
  3483. `Marked' to change all marked addresses and `All' to (un)set the group
  3484. flags of all (visible) addresses.
  3485.  
  3486. Search
  3487. ------
  3488.  
  3489. Another window pops up that allows you to enter several search criteria
  3490. (cf. EditorSearch):
  3491.  
  3492. Search Next
  3493. -----------
  3494.  
  3495. `Search Next' can be selected only, if there has been given a search
  3496. pattern previously using the `Search' function. If this is the case,
  3497. the next matching entry is displayed (not marked!).
  3498.  
  3499. Print
  3500. -----
  3501.  
  3502. After you have selected `Print', another window pops up, which gives
  3503. you several ways to print your addresses, as it is described in
  3504. EditorPrint.
  3505.  
  3506. Sort
  3507. ----
  3508.  
  3509. `Sort' sorts the complete address list. As long as you use the default
  3510. setting, the list is sorted by name, first name and city (in this
  3511. order). If you prefer another sort order, you may change it in the
  3512. *DFA-Preferences*.
  3513.  
  3514. Dial
  3515. ----
  3516.  
  3517. Another window pops up, which allows you to dial phone numbers (cf.
  3518. EditorDial).
  3519.  
  3520. Select Groups
  3521. -------------
  3522.  
  3523. This menu item has the two submenus `All' and `None'; accordingly all
  3524. group flags are either selected or deselected.
  3525.  
  3526. Preferences
  3527. -----------
  3528.  
  3529. The *DFA-Preferences* program is loaded. Please notice that the
  3530. tooltype `DFAPREFS' of the *DFA-Editor* has to be set correctly to
  3531. enable the *DFA-Editor* to find the *DFA-Preferences* program! This has
  3532. usually already been done by the install program.
  3533.  
  3534. Edit Template
  3535. -------------
  3536.  
  3537. The window that pops up will be quite familiar to you, as it is exactly
  3538. the same as in EditorEdit or EditorNew. You may enter several *presets*
  3539. here, which are automatically copied into the corresponding fields, just
  3540. before you enter a *new* address. The template strings are saved in the
  3541. address file, so it is possible to have different templates for every
  3542. address file.
  3543.  
  3544. Use Template Script
  3545. -------------------
  3546.  
  3547. This toggle menu switches the usage of the template script on or off.
  3548. As soon as the Template script is *not* used, the usual template
  3549. address will be used (see EditorMenuEditTemplate.
  3550.  
  3551. Use PostProcess Script
  3552. ----------------------
  3553.  
  3554. This toggle menu item switches the usage of the postprocess on or off.
  3555. As soon as the postprocess script is used, the AREXX script that may be
  3556. selected from within the *DFA-Preferences*, will be executed after the
  3557. input of a new address.
  3558.  
  3559. Dieses Umschalt-Menü schaltet die Nutzung des
  3560. Nachbearbeitungs-Arexx-Skripts ein oder aus. Sobald das
  3561. Nachbearbeitungs-Skript benutzt wird, wird nach der Eingabe einer neuen
  3562. Adresse das in den *DFA-Preferences* eingestellte AREXX-Skript
  3563. ausgeführt.
  3564.  
  3565. Write Access
  3566. ------------
  3567.  
  3568. This menu item can only be selected if you have activated the network
  3569. mode before.
  3570.  
  3571. Starting with version 2.0, *DFA* supplies a simple network mode. This
  3572. network mode has been developed to make it possible for several
  3573. connected computers to use the same address file. The problem that
  3574. comes up, when an address file is used by more than one user at the
  3575. same time is the following:
  3576.  
  3577. If several users change the address file at the same time, the last
  3578. saved address file overwrites the previously saved ones. The previously
  3579. saved changes are lost!
  3580.  
  3581. *DFA* tries to solve this problem in the following way:
  3582.  
  3583. If the network mode is active, all operations that change the address
  3584. database are forbidden, i.e. saving, changing, marking of addresses is
  3585. not possible. It is allowed however, to view the addresses (`Full'), to
  3586. scroll within the address list, to print the addresses and so on.
  3587.  
  3588. If you want to do some changes on the addresses, you have to obtain
  3589. write access to the address file. This can be done using the AREXX
  3590. command `ATTEMPTLOCK' or by selecting the menu item `Write Access' in
  3591. the *DFA-Editor*.
  3592.  
  3593. If your try to get write access was successful, you may change the
  3594. addresses. If you've completed your changes, you should free the write
  3595. access using either the AREXX command `FREELOCK' or the menu item
  3596. `Write Access' in the *DFA-Editor*. After you have done so, other
  3597. members of the LAN can get write access to this address file.
  3598.  
  3599. Instead of getting permanent write access, the *DFA-Editor* supplies
  3600. the socalled "auto lock mode". This mode is activated automatically, as
  3601. soon as you've switched on the network mode. If you want to change
  3602. anything, the *DFA-Editor* tries to get write access to the address
  3603. file automatically and releases the write access as soon as the change
  3604. is done.
  3605.  
  3606. Load Preferences
  3607. ----------------
  3608.  
  3609. Select this menu item, if you want to load another preferences file.
  3610. Using this feature of *DFA* makes it possible to use different settings
  3611. for different purposes, i.e. for different address files.
  3612.  
  3613. Save Preferences
  3614. ----------------
  3615.  
  3616. As the window coordinates and several other settings of the
  3617. *DFA-Editor* are saved together with the preferences that can be tuned
  3618. in the *DFA-Preferences* program, there is the opportunity to save the
  3619. preferences not only from within the *DFA-Preferences* program, but
  3620. from the *DFA-Editor* as well using this menu item.
  3621.  
  3622. Save Preferences as
  3623. -------------------
  3624.  
  3625. If you want to save the settings with another name than the default
  3626. (this makes sense, if you use different preferences files), select this
  3627. menu item. A file requester pops up and you may select the wanted file
  3628. name.
  3629.  
  3630. Arexx Commands
  3631. --------------
  3632.  
  3633. All AREXX scripts can be reached not only by the functions keys, but by
  3634. these menu items as well.
  3635.  
  3636. Sorting of the Address Display
  3637. ------------------------------
  3638.  
  3639. Using one of these menu items, it is possible to sort the address
  3640. display of the *DFA-Editor*. Depending on which menu item you select
  3641. (`Salutation', `Name', etc.), the addresses are sorted in the desired
  3642. way.
  3643.  
  3644. This sorting has only effect to the displayed addresses and is *not*
  3645. permanet, i.e. the sorting refers to the display of the addresses only,
  3646. and *not* to the internal managment of the addresses! Because of this,
  3647. the original order of the addresses is restored, as soon as you change
  3648. the group selection, for example; the addresses are saved in the
  3649. original order as well.
  3650.  
  3651. Someone may ask now by himself, what sense a sort function make that
  3652. has an effect only for quite a short time. But wouldn't it be nice to
  3653. sort the addresses by their `ZIP' on demand, just to look which people
  3654. live near to each other. Or sort the display by the city and you have
  3655. all addresses of a specified town listed one beyond the other.
  3656.  
  3657. On the long run, such a sorting doesn't make much sense. Therefore, to
  3658. sort the addresses permanently, the usual sort function in connection
  3659. to the *DA-Preferences* programm has to be used.
  3660.  
  3661. *Please notice:*
  3662.  
  3663. If you've just sorted your *display*, the `Quick Search' function
  3664. (`RSHIFT <letter>') cannot work correctly! In this case, restore the
  3665. original sort order; either by changing the group selection or by
  3666. selecting the "normal" sort function.
  3667.  
  3668.  
  3669. Full
  3670. ====
  3671.  
  3672. `Full' can only be selected if there is a current address! If this is
  3673. the case, another window pops up (title: `Full address...'), which
  3674. displays *all* fields of the current address.
  3675.  
  3676. If there is an external file for the current address, you may select
  3677. the `View external' button to start the ASCII viewer together with the
  3678. corresponding external file.
  3679.  
  3680. Please notice that the ASCII viewer of your choice may be entered in
  3681. the *DFA-Preferences* program (cf. EditorEdit).
  3682.  
  3683. The listview that displays the different fields of the current address
  3684. may be scrolled as follows:
  3685.  
  3686.       Cursor down       The listview scrolls *up*.
  3687.  
  3688.      Cursor up        The listview scrolls *down*.
  3689.  
  3690. Below this listview there is a gadget panel that may be used to step
  3691. through the addresses:
  3692.  
  3693.    * *First*
  3694.  
  3695.      The first entry of the address list is displayed. Besides the
  3696.      underlined letter you may alternatively use `CRTL + Cursor Left'
  3697.      as the corresponding gadget shortcut.
  3698.  
  3699.    * *Last*
  3700.  
  3701.      The last entry of the address list is displayed. Besides the
  3702.      underlined letter you may alternatively use `CRTL + Cursor Right'
  3703.      as the corresponding gadget shortcut.
  3704.  
  3705.    * *Prev. Sel.*
  3706.  
  3707.      If there is a selected item in front of the current one, it is
  3708.      displayed. Besides the underlined letter you may alternatively use
  3709.      `SHIFT + Cursor Left' as the corresponding gadget shortcut.
  3710.  
  3711.    * *Next Sel.*
  3712.  
  3713.      If there is a selected item behind of the current one, it is
  3714.      displayed. Besides the underlined letter, you may alternatively use
  3715.      `SHIFT + Cursor Right' as the corresponding gadget shortcut.
  3716.  
  3717.    * *Prev.*
  3718.  
  3719.      The previous entry of the address list is displayed. Besides the
  3720.      underlined letter, you may alternatively use `Cursor Left' as the
  3721.      corresponding gadget shortcut.
  3722.  
  3723.    * *Next*
  3724.  
  3725.      The next entry of the address list is displayed. Besides the
  3726.      underlined letter, you may alternatively use `Cursor Left' as the
  3727.      corresponding gadget shortcut.
  3728.  
  3729. `Ok' closes the window, `Edit' opens the `Edit' window. The `Edit'
  3730. window is described in further detail in EditorEdit.
  3731.  
  3732. Edit
  3733. ====
  3734.  
  3735. If a current address exists (cf. EditorFull), a window pops up, where
  3736. you may change any part of the address. The string gadgets have some
  3737. additional features compared to the "original" ones:
  3738.  
  3739.    - Hit `RETURN' to end the input to the current gadget and go to the
  3740.      next string or integer gadget. You may use the `ENTER' key
  3741.      alternatively.
  3742.  
  3743.    - Hit `SHIFT' `RETURN' to end the input to the current gadget and go
  3744.      to the *previous* gadget.
  3745.  
  3746.    - Hitting `CURSOR UP' or `CURSOR DOWN' brings the cursor to the
  3747.      previous or next string gadget respectively.
  3748.  
  3749.    - Hit `ESCAPE' to cancel the input into the current string gadget.
  3750.  
  3751.    - If the cursor is within a string gadget, the gadget shortcuts can
  3752.      be reached by hitting `RIGHT AMIGA'-`letter' and `SHIFT'. If you
  3753.      don't hit `SHIFT' additionally, the keyboard shortcut is used
  3754.      either by the internal string gadget edit features (like `RIGHT
  3755.      AMIGA X' or `RIGHT AMIGA Q') or by additional tools (like
  3756.      `NewList').
  3757.  
  3758. As soon as *no* string gadget is activated, you may move through the
  3759. address list using the cursor keys:
  3760.  
  3761.  
  3762.         Cursor right     Show next address
  3763.         Cursor left      Show previous address
  3764.      
  3765.      SHIFT+Cursor right  Show next selected address
  3766.      SHIFT+Cursor left   Show previous selected address
  3767.      
  3768.      CRTL+Cursor right   Show last address
  3769.      CRTL+Cursor left    Show first address
  3770.  
  3771. The `Edit' fields are:
  3772.  
  3773.      Address         Address
  3774.      First           First name
  3775.      Name            Name
  3776.      c/o             may be used for additional information
  3777.      Street          Street/No.
  3778.      Zip             Zip
  3779.      City            City
  3780.      State           State
  3781.      Country         Country
  3782.      Birthday        Birthday
  3783.      Phone           Telphone number. Seperate multiple phone numbers
  3784.                      by a pipe sign (`|').
  3785.      Fax             Telefax number
  3786.      Email1          email address # 1
  3787.      Email2          email address # 2
  3788.      Email3          email address # 3
  3789.      Comment         Comment
  3790.  
  3791. Please notice that it is possible to enter more than one phone number
  3792. into the `Phone' field. These numbers can be dialed correctly as well,
  3793. as long as you separate them by a pipe sign (`|').
  3794.  
  3795. Using the `Address selected' checkbox you may set (or unset) the
  3796. selection state of the current address.
  3797.  
  3798. If you hit `External' you activate the ASCII-Editor (default: `ed').
  3799. This makes sense if you want to enter a long text (for example: How to
  3800. find the way to Joe User, living in New York City).  When you have
  3801. finished your input, save the file with the *given name* and quit the
  3802. editor. The *DFA-Editor* remembers the file name, so it is then
  3803. possible to access this external file e.g.  from the `Full' window (cf.
  3804. EditorFull) or from the `Edit' window to modify it.
  3805.  
  3806. As soon as there is an external file for the current address item, the
  3807. `Del.' button can be used to delete an external file as soon as you no
  3808. longer need it.
  3809.  
  3810. All external files get their unique file name from *DFA*. This file
  3811. name is guaranteed to be *unique* within the given directory (default:
  3812. `s:DFAExternals'). *DFA* only saves the filename -- not the file
  3813. itself, so this is completely up to you.  Please do not change the
  3814. filename given by *DFA*, as if you do so, *DFA* will no longer be able
  3815. to find this file! If you want to delete one (or more) external files,
  3816. you have to use the `Del.' function of this window. This is the only
  3817. way to make sure that not only the file itself is deleted, but the
  3818. filename, which is stored by *DFA* as well!
  3819.  
  3820. You may set your favourite ASCII editor, as well as the wanted
  3821. directory for the external files, in the *DFA-Preferences* program.
  3822.  
  3823. Hit `Ok' to use the changes; if you select `Cancel' instead, all
  3824. changes are discarded.
  3825.  
  3826. New
  3827. ===
  3828.  
  3829. `New' opens a window that looks exactly like the `Edit' window! Nearly
  3830. all functions within this window are the same as in the `Edit' window
  3831. (see EditorEdit for details), with the following exceptions:
  3832.  
  3833.    * *Using the usual template address*
  3834.  
  3835.      As soon as you disabled the using of the template script (see
  3836.      EditorMenuUseTemplate), the usual template address is used, i.e.
  3837.      all data you entered using `Edit Template' (cf.
  3838.      EditorMenuEditTemplate), are copied into the new address fields
  3839.      just before you can start entering new data.
  3840.  
  3841.    * *Using the template AREXX script*
  3842.  
  3843.      If you switch on the usage of the template AREXX script (see
  3844.      EditorMenuUseTemplate), the template address will no longer be
  3845.      used. Instead you may set the templates by an AREXX script, using
  3846.      the AREXX command `EDITTEMPLATE' for example.
  3847.  
  3848.      The advantage you can  get out of this feature is that it is
  3849.      possible now to enter non-constant data into the address fields
  3850.      automatically. For example you could write a script that enters
  3851.      the current date into the comment field of the new address.
  3852.  
  3853.      One important note:
  3854.  
  3855.      Usually, the AREXX command `EDITTEMPLATE' does nothing but to
  3856.      change the fields of the template address. In connection with the
  3857.      `New' command of the *DFA-Editor*, however, this AREXX command can
  3858.      be seen to be "local", i.e. the changes you are doing in this AREXX
  3859.      script are valid for the currently new address only! After you've
  3860.      entered the address, the usual template address is restored.
  3861.  
  3862.      In every other context, the changes you do using the `EDITTEMPLATE'
  3863.      AREXX command, stay permanent!
  3864.  
  3865.      Not all AREXX commands can be used within this AREXX script, due
  3866.      to the conflicts this could lead to (e.g. the AREXX command
  3867.      `EDIT').
  3868.  
  3869.      If you are not sure, if the usage of an AREXX command is possible
  3870.      -- just try it out.
  3871.  
  3872.  
  3873.    * *The Postprocess AREXX Script*
  3874.  
  3875.      If you have activated the postprocess script (either by selecting
  3876.      the corresponing menu item or by the *DFAPrefs* program), this
  3877.      AREXX script will be executed. It is possible for example, to send
  3878.      and automaticly generated eMail to every new entry with an email
  3879.      address.
  3880.  
  3881.      To write your own template or postprocess script it is useful, to
  3882.      know how the `New' function of *DFA* works.
  3883.  
  3884.        1. If you want to use the template script, the template address
  3885.           (see EditorMenuEditTemplate) is stored.
  3886.  
  3887.        2. The template script is executed (if selected). Please notice
  3888.           that the new address still doesn't exist, so the AREXX command
  3889.           `GETCURRENT' e.g. can't return it.
  3890.  
  3891.        3. A new address is created using the data of the template
  3892.           address. This template address could have been changed by the
  3893.           AREXX command `EDITOTEMPLATE' out of the template script.
  3894.  
  3895.        4. The `Edit'-Window is opened - the new address can be entered.
  3896.  
  3897.        5. As soon as you finished entering the address data, the
  3898.           formerly stored template address is restored (if needed).
  3899.  
  3900.        6. The postprocess script is executed. Please notice that the
  3901.           `EDITTEMPLATE' command works *no longer* local here!
  3902.           Furthermore the `GETCURRENT' command does return the just
  3903.           entered new address.
  3904.  
  3905.  
  3906.    * *Next New*
  3907.  
  3908.      Using the `Next New' button, you may finish the input of the
  3909.      current address and start to enter another one, *without* having
  3910.      to leave the window.
  3911.  
  3912. Search
  3913. ======
  3914.  
  3915. You may enter several search criteria in this window.
  3916.  
  3917.    * *Search for*
  3918.  
  3919.      Here you may enter the search pattern. You must use the known
  3920.      *AMIGA* patterns.  You need to enter a `#?' or a `*' infront of
  3921.      and behind the search string either if you want to look for
  3922.      partial strings!  This means, you have to input
  3923.      `#?PartialString#?' instead of `PartialString'. Let's say you want
  3924.      to search for first names that start with `Mi', you have to enter
  3925.      `Mi#?'. If you want to look for cities that end in `town', you
  3926.      have to enter `#?town'.
  3927.  
  3928.      The following patterns are supported:
  3929.  
  3930.     ?
  3931.           The question mark matches any single character. For example,
  3932.           the pattern matching string `A?B' matches any string that is
  3933.           three letters long, that starts with an `A' and ends with a
  3934.           `B'.
  3935.  
  3936.     #
  3937.           The number sign matches strings containing zero or more
  3938.           repetitions of the expression that immediately follows the
  3939.           `#' in the pattern matching string.  For example, the pattern
  3940.           matching string `#A' matches any string that consists of one
  3941.           or more of the `A' character.  The pattern matching string
  3942.           `#?' matches any non-NULL string.  The `#' can apply to
  3943.           entire substrings delimited by parentheses.  For example, the
  3944.           pattern string `#(AB)' matches any string consisting of one
  3945.           or more repetitions of the substring `AB' (`AB', `ABAB',
  3946.           `ABABAB',...).
  3947.  
  3948.     %
  3949.           Matches the NULL string.
  3950.  
  3951.     |
  3952.           This is the OR symbol.  This matches strings that contain the
  3953.           expressions on either side of the OR sign.  The expressions
  3954.           and the OR symbol need to be enclosed in parentheses.  For
  3955.           example, the pattern matching string `(A|B)' matches the
  3956.           string `A' or the string `B'.  The pattern matching string
  3957.           `A(B|%|C)' matches the strings `AB', `A', and `AC'.
  3958.  
  3959.     ~
  3960.           The tilde negates the expression that follows it.  All
  3961.           strings that do not match the expression that follows the
  3962.           tilde will match the expression with the tilde.  For example,
  3963.           the pattern matching string `~(#?.info)' matches any string
  3964.           that does not match the string `#?.info' (does not end with
  3965.           the substring `.info').
  3966.  
  3967.     *
  3968.           The star is provided as a synonym to `#?'.
  3969.  
  3970.     [ ]
  3971.           All characters within brackets indicate a character class.
  3972.           Any character in the character class qualifies.  Within a
  3973.           character class, a character range can be indicated by
  3974.           specifing the start and stop character, separated with a
  3975.           minus sign.  Note that character classes are case sensitive.
  3976.           If character classes are to be used in a case insensitive
  3977.           form, they should be translated to uppercase.  Here are some
  3978.           examples:
  3979.  
  3980.          [ACF]#?
  3981.                matches strings starting with `A', `C', or `F'
  3982.  
  3983.          [A-D]#?
  3984.                matches strings starting with `A', `B', `C' or `D'
  3985.  
  3986.          [~ACF]#?
  3987.                matches strings *not* starting with `A', `C' or `F'
  3988.  
  3989.     '
  3990.           The quote character neutralizes the special meaning of a
  3991.           special character.  Here are some examples:
  3992.  
  3993.          '#'?
  3994.                matches only the literal string `#?'
  3995.  
  3996.          '?(A|B|C|%)'# matches the literal strings `?#', `?A#',
  3997.                `?B#', `?C#'
  3998.  
  3999.          "
  4000.                The quote itself
  4001.  
  4002.     ( )
  4003.           Parentheses group special characters.  The expression within
  4004.           the parentheses is a subpattern.
  4005.  
  4006.    * *Ignore case*
  4007.  
  4008.      If the box is "checked", the search will not be case sensitive. If
  4009.      the box is empty, however, case will be noticed.
  4010.  
  4011.    * *Use Wildcards*
  4012.  
  4013.      If you select this checkbox, you may even use *AmigaDOS* patterns
  4014.      for the search string (default).
  4015.  
  4016.    * *All*
  4017.  
  4018.      Select all fields.
  4019.  
  4020.    * *None*
  4021.  
  4022.      Unselects all fields.
  4023.  
  4024.    * *Fields to search*
  4025.  
  4026.      You may select which fields you would like to search. It is
  4027.      possible to toggle each single field. The default is to search all
  4028.      fields.
  4029.  
  4030.    * *Search*
  4031.  
  4032.      `Search' starts the search. If a matching item is found, the
  4033.      address listview scrolls to the corresponding place and the
  4034.      matching entry becomes the current one.
  4035.  
  4036.    * *Cancel*
  4037.  
  4038.      `Cancel' terminates the search.
  4039.  
  4040. Print
  4041. =====
  4042.  
  4043. This window contains all functions that may be used to print the
  4044. addresses.
  4045.  
  4046.    * *Print*
  4047.  
  4048.      You can choose between all (`All'), the marked (`Selected') and
  4049.      the active address (`Active').  If there is an active item, it
  4050.      will be shown in the `Active Item' field.
  4051.  
  4052.    * *Print to*
  4053.  
  4054.      You can either print to the printer (`PRT:') or to a file
  4055.      (`File'). If you print your addresses to a file, the settings
  4056.      below don't take effect. Notice that always all parts of an address
  4057.      are written to the file!
  4058.  
  4059.    * *Print style*
  4060.  
  4061.      You may choose, whether the addresses are to be printed in `NLQ' or
  4062.      `Condensed' style (or both).
  4063.  
  4064.      If you select `Formfeed', a formfeed is performed after the very
  4065.      *last* printed address entry.  To switch this off will be useful,
  4066.      if you want to print a few address labels only and you don't want
  4067.      to waste these sheets.
  4068.  
  4069.    * *Print form*
  4070.  
  4071.      There are five different forms, between which you may choose:
  4072.  
  4073.         - Short address list
  4074.  
  4075.         - Full address list
  4076.  
  4077.         - Phonelist (fixed columns)
  4078.  
  4079.         - Mailing labels (70mm x 36mm)
  4080.  
  4081.         - Address cards
  4082.  
  4083.    * *Print*
  4084.  
  4085.      If you did select `File' for output, a file requester will be
  4086.      opened, which allows you to enter the filename.  Be careful!  This
  4087.      output file is *not* compatible to the internal address file
  4088.      format (default: `s:adr.file'); so don't overwrite this (these)
  4089.      file(s). To write the addresses to a file may be useful if you
  4090.      want to export addresses, but don't wan't to use AREXX.
  4091.  
  4092.      If you send your addresses to the printer (`PRT:'), another window
  4093.      is opened that displays the progress of printing. You may stop the
  4094.      output after every complete address (`Cancel'). If only the active
  4095.      item is printed, no progress indicator is shown.
  4096.  
  4097.    * *Cancel*
  4098.  
  4099.      `Cancel' terminates the complete printing process.
  4100.  
  4101. *Please notice:*
  4102.  
  4103. Of course, *DFA*'s abilities to print are a bit limited, and it can't
  4104. compete with the abilities of a DTP program.  I think, however, that it
  4105. does make much more sense to let programs print your addresses that are
  4106. specialized in printing.  Such programs give you much more features and
  4107. often result in a much better printing quality than an address utility
  4108. could ever reach.  So *DFA* should be used to supply the stored
  4109. addresses to (spezialized) printing programs and not not print the
  4110. addresses by itself.  An ideal mean for this purpose is the AREXX port
  4111. for sure, which is not only part of *DFA*, but of many printing
  4112. programs as well.
  4113.  
  4114. Even if your favourite printing program doesn't have an AREXX port, you
  4115. may use *DFA*'s AREXX interface to export and format the address, so
  4116. other programs can easily use them.
  4117.  
  4118. Dial
  4119. ====
  4120.  
  4121. *For owners of modems only!*
  4122.  
  4123. If you have a modem connected to your computer, it is possible to let
  4124. the computer dial the stored phone number(s). If you have entered more
  4125. than one number into the phone field, they must be seperated by a
  4126. `pipe' sign (`|'). When you start dialing a status window pops up. You
  4127. may either dial the current address or all selected addresses.
  4128.  
  4129. You can cancel the dialing at any time (`Cancel') or skip the current
  4130. number (`Skip').
  4131.  
  4132. To be able to let the computer dial phone numbers, it is needed that
  4133. you connected your modem to the socket and your phone to the modem.
  4134. After *DFA* has successfully dialed the number, you have to transfer
  4135. the connection from the modem to the phone; hit `Cancel' to do so.
  4136.  
  4137. If the line is just busy, *DFA* redials until it succeeds or the
  4138. maximum number of phone calls is reached.
  4139.  
  4140. The modem settings can be changed in the `DFA-Preferences' program.
  4141.  
  4142. The DFA-Preferences Program
  4143. ***************************
  4144.  
  4145. The *DFA-Preferences* program (filename: `DFAPrefs') may be used to
  4146. configure *DFA*. It can be started from the *DFA-Editor* (menu item
  4147. `Settings->Preferences') as well as directly from the Workbench or the
  4148. Shell.
  4149.  
  4150. Tool Types
  4151. ==========
  4152.  
  4153. If you click on the *DFA-Editor* icon once and then activate the
  4154. Information program of the Workbench, you may adjust the following
  4155. tooltypes:
  4156.  
  4157.    * *`PUBSCREEN'*
  4158.  
  4159.      If you enter the *name* of a public screen together with this
  4160.      tooltype, you may select an alternate (public) screen for the
  4161.      *DFA-Preferences* program to open on.
  4162.  
  4163.      For example:
  4164.  
  4165.  
  4166.               PUBSCREEN=TERM
  4167.  
  4168.      If the given public screen exists when the *DFA-Preferences*
  4169.      program comes up, it opens its window(s) on this screen, otherwise
  4170.      on the default public screen, usually the Workbench screen.
  4171.  
  4172.    * *`UPPERPUBSCREEN'*
  4173.  
  4174.      If you enter `UPPERPUBSCREEN=YES', you tell the *DFA-Prefs*
  4175.      program to open its window(s) on the frontmost *public* screen. If
  4176.      the current frontmost screen isn't public, the *DFA-Preferences*
  4177.      program comes up on the screen you selected with the tooltype
  4178.      `PUBSCREEN'; if this fails as well, the *DFA-Preferences* program
  4179.      opens its window(s) on the default public screen.
  4180.  
  4181.    * *`GUIDEFILE'*
  4182.  
  4183.      To make the online help work, the *DFA-Preferences* program has to
  4184.      know where to find the online help file. This can be done via the
  4185.      tooltype `GUIDEFILE'. The default for this Tool Type is set by the
  4186.      install program.
  4187.  
  4188. CLI-Parameter
  4189. =============
  4190.  
  4191. If you start the *DFA-Preferences* program from the shell (or the CLI),
  4192. it uses the *tooltypes* of the corresponding `.info' file! However, you
  4193. may overwrite these setting by giving one or more of the following CLI
  4194. parameters:
  4195.  
  4196.  
  4197.      PUBSCREEN/K, UPPERPUBSCREEN/K, GUIDEFILE/K
  4198.  
  4199. This means, you may use...
  4200.  
  4201.    ... `DFAPrefs PUBSCREEN=TERM' to make the *DFA-Preferences* program
  4202.      open its window(s) on the public screen named `TERM'.
  4203.  
  4204.    ... `DFAPrefs UPPERPUBSCREEN=YES' to make the *DFA-Preferences*
  4205.      program open its window(s) on the frontmost screen, as long as
  4206.      this is a public screen.
  4207.  
  4208.    ... `DFAPrefs GUIDEFILE=Help:DFAPrefs.guide' to set another path for
  4209.      the online help file.
  4210.  
  4211. The DFA-Preferences Main Window
  4212. ===============================
  4213.  
  4214. From the main window you can reach all subwindows. You may either open
  4215. one subwindow at a time or several subwindows at the same time.
  4216.  
  4217. Please notice that all settings that you confirm using `Ok' become
  4218. active at once and stay active until you change them again or leave
  4219. *DFA*.
  4220.  
  4221. Save Preferences
  4222. ----------------
  4223.  
  4224. Saves the preferences.
  4225.  
  4226. Use Preferences
  4227. ---------------
  4228.  
  4229. Saves the preferences temporarily to `ENV:DFA/DFA.prefs', i.e. the
  4230. preferences stay active until you reboot the computer.
  4231.  
  4232. Remove DFA
  4233. ----------
  4234.  
  4235. Removes a running *DFA* application, i.e. the *DFA-Server* *and* the
  4236. *DFA-Editor* will be terminated, if they are currently running.
  4237.  
  4238. Quit Preferences
  4239. ----------------
  4240.  
  4241. Quits the *DFA-Preferences* program.
  4242.  
  4243. About
  4244. -----
  4245.  
  4246. In the `About' window you'll find something useful about the program
  4247. itself and the author:
  4248.  
  4249.    * the version number as well as a notice, if you are a registered
  4250.      user.
  4251.  
  4252.    * The copyright notice and the address of the author (incl.  email
  4253.      address(es)).
  4254.  
  4255.    * Your name, address and the serial number if you are a registered
  4256.      user.
  4257.  
  4258. Open Preferences
  4259. ----------------
  4260.  
  4261. A file requester pops up and you may select another than the default
  4262. preferences file. After loading the preferences file, all open windows
  4263. are updated to the new settings.
  4264.  
  4265. Save Preferences
  4266. ----------------
  4267.  
  4268. See See PrefsMainSave.
  4269.  
  4270. Save Preferences as
  4271. -------------------
  4272.  
  4273. A file requester pops up and you may enter the name under which you want
  4274. to save the current settings.
  4275.  
  4276. Use
  4277. ---
  4278.  
  4279. See See PrefsMainUse.
  4280.  
  4281. Remove DFA
  4282. ----------
  4283.  
  4284. See See PrefsMainRemove.
  4285.  
  4286. Quit Preferences
  4287. ----------------
  4288.  
  4289. See See PrefsMainQuit.
  4290.  
  4291. Reset To Defaults
  4292. -----------------
  4293.  
  4294. All values are reset to the builtin default values.
  4295.  
  4296. Last Saved
  4297. ----------
  4298.  
  4299. The preferences are reset to the vaules last saved in in
  4300. `ENVARC:DFA/DFA.prefs'.
  4301.  
  4302. Restore
  4303. -------
  4304.  
  4305. The preferences are reset to the vaules last saved in in
  4306. `ENV:DFA/DFA.prefs'.
  4307.  
  4308. Miscelleneous
  4309. =============
  4310.  
  4311. Application Icon
  4312. ----------------
  4313.  
  4314.      The string gadgets `XPos' and `YPos' make it possible to enter the
  4315.      application icon's position on the Workbench screen (referring to
  4316.      the upper left corner of the screen)
  4317.  
  4318.      Alternatively to this direct input of raw coordinates there is a
  4319.      more convenient possibility to change the application icon's
  4320.      position:
  4321.  
  4322.      As soon as you click (once) on the cycle gadget `Open position
  4323.      window', a small window (title: `Move me') is opened. This window
  4324.      can be moved (using the mouse) on the Workbench. As soon as the
  4325.      position fits your wishes you should click on the gadget `Close
  4326.      position window' (the same gadget as before, just with another
  4327.      text in it). The `Move Me' window is closed and the new icon
  4328.      position is displayed in the `XPos' and `YPos' gadgets.
  4329.  
  4330.      Using the checkbox gadget `Show', you can switch the application
  4331.      icon on and off.
  4332.  
  4333. Application Menu
  4334. ----------------
  4335.  
  4336. It is possible to reach the *DFA-Editor* via an menu item of the
  4337. Workbench's "Tools" menu while the *DFA-Server* is running.  To enable
  4338. the menu item, switch this checkbox on.
  4339.  
  4340. Auto Save
  4341. ---------
  4342.  
  4343. There are several ways to make sure that your addresses are saved
  4344. regularly:
  4345.  
  4346.    * *Save always*
  4347.  
  4348.      If you have changed some addresses using the *DFA-Editor*, the
  4349.      address file is saved as soon as you leave the *DFA-Editor* -- no
  4350.      matter if using `Quit' or `Remove'.
  4351.  
  4352.    * *Ask*
  4353.  
  4354.      If the addresses have been changed, a requester pops up as soon as
  4355.      you want to leave the *DFA-Editor*, which asks you if you would
  4356.      like to save the addresses.
  4357.  
  4358.    * *Remove only*
  4359.  
  4360.      The changed addresses will only be saved, if the *DFA-Editor* is
  4361.      left using the `Remove' function (i.e. you quit the complete *DFA*
  4362.      application), but not if you use the `Quit' function.
  4363.  
  4364.      *Be careful:*
  4365.  
  4366.      Please notice that the functions `Quit' and `Remove' of the
  4367.      *DFA-Editor* are exactly the same, if you *don't* have the
  4368.      *DFA-Server* program running at the same time! If there is running
  4369.      only the *DFA-Editor* and you've choosen `Remove only' for auto
  4370.      save mode, changed addresses are *not* saved, if you select `Quit'
  4371.      in the *DFA-Editor*.
  4372.  
  4373.  
  4374. Icon Creation
  4375. -------------
  4376.  
  4377. If you want *DFA* to save an icon together with the address files, you
  4378. have to switch this checkbox to *ON* state. To get an icon for every
  4379. address database file make sense e.g. if you like to use *DFA*'s
  4380. application window.
  4381.  
  4382. Hires Mode
  4383. ----------
  4384.  
  4385. If you select this checkbox, *DFA* tries to use an alternate window
  4386. layout for *some* windows. E.g. the edit window will appear with more
  4387. space for the string gadgets. If you select this hires mode and don't
  4388. have anough space on your screen (640x400 pixels should be sufficient),
  4389. *DFA* falls back to the original space-saving window layout
  4390. automatically.
  4391.  
  4392. Secret Mode
  4393. -----------
  4394.  
  4395. Not everyone likes *DFA* informing everybody about how many addresses
  4396. are sorted, saved, loaded and so on. If you select `Secret Mode',
  4397. instead of the number of addresses, three dots are displayed.
  4398.  
  4399. Networking
  4400. ----------
  4401.  
  4402. Starting with version 2.0, *DFA* supplies a simple network mode. This
  4403. network mode has been developed to make it possible for several
  4404. connected computers to use the same address file. The problem that
  4405. comes up, when an address file is used by more than one user at the
  4406. same time is the following:
  4407.  
  4408. If several users change the address file at the same time, the last
  4409. saved address file overwrites the previously saved ones. The previously
  4410. saved changes are lost!
  4411.  
  4412. *DFA* tries to solve this problem in the following way:
  4413.  
  4414. If the network mode is active, all operations that change the address
  4415. database are forbidden, i.e. saving, changing, marking of addresses is
  4416. not possible. It is allowed however, to view the addresses (`Full'), to
  4417. scroll within the address list, to print the addresses and so on.
  4418.  
  4419. If you want to do some changes on the addresses, you have to obtain
  4420. write access to the address file. This can be done using the AREXX
  4421. command `ATTEMPTLOCK' or by selecting the menu item `Write Access' in
  4422. the *DFA-Editor*.
  4423.  
  4424. If your try to get write access was successful, you may change the
  4425. addresses. If you've completed your changes, you should free the write
  4426. access using either the AREXX command `FREELOCK' or the menu item
  4427. `Write Access' in the *DFA-Editor*. After you have done so, other
  4428. members of the LAN can get write access to this address file.
  4429.  
  4430.    * *Network mode*
  4431.  
  4432.      The checkbox gadget `Network mode' may be used to switch the
  4433.      network mode on and off. Please notice, however, that using this
  4434.      feature makes only sense if you really have a network installed
  4435.      and want to access the same address file from several computers.
  4436.  
  4437.    * *Retries*
  4438.  
  4439.      Number of retries to get write access to the current address file.
  4440.  
  4441.    * *Retry delay*
  4442.  
  4443.      Number of seconds that may pass between two tries to get write
  4444.      access.
  4445.  
  4446. Address Listview
  4447. ================
  4448.  
  4449. This window may be used to configure the main (address) listview of the
  4450. *DFA-Editor*:
  4451.  
  4452. Each line of the address listview contains one address. Each line may
  4453. have up to eight columns. Each column can display any field of the
  4454. particular address.
  4455.  
  4456.    * *Column*
  4457.  
  4458.      This cycle gadget supplies means to select the desired column. You
  4459.      may configure up to eight columns, i.e. `Column 1' through
  4460.      `Column 8'.
  4461.  
  4462.    * *Fields*
  4463.  
  4464.      This listview contains the field name of all address fields that
  4465.      may be used. Please notice that the `Groups' entry displays all
  4466.      eight group flags of the particular address using the following
  4467.      format:
  4468.  
  4469.           12345678
  4470.  
  4471.      ...if there are *all* groups flags set. For every group that isn't
  4472.      set, instead of the corresponding group number, there will be
  4473.      displayed a minus sign (`-').
  4474.  
  4475.      Some examples:
  4476.  
  4477.  
  4478.           123-----          Only the groups 1,2 and 3 are set
  4479.           1-3-5---          Only the groups 1,3 and 5 are set
  4480.           ------78          Only the groups 7 and 8 are set
  4481.           --------          No group flag is set
  4482.  
  4483.    * *Weight*
  4484.  
  4485.      The number given here is the percentage of the particular column
  4486.      referring to the complete line. Please notice that it is possible
  4487.      to give up to 100 %, but not more than this! If there is not
  4488.      enough space left for the column you're currently working on, you
  4489.      have to reduce one or more columns accordingly.
  4490.  
  4491.      If you enter a number into the `Weight' gadget that is too large,
  4492.      the program corrects the value and replaces it with the highest
  4493.      possible number.
  4494.  
  4495.      As the display of the group flags needs a fixed number of eight
  4496.      characters, it is not possible to give a weight for this field.
  4497.  
  4498.    * *Free and Used*
  4499.  
  4500.      To give you a general view of the used and free space within the
  4501.      line, there are two gadgets, `Used [%]' and `Free [%]', which
  4502.      display the used and free space respectively.
  4503.  
  4504.    * *Move left*
  4505.  
  4506.      Moves the current column left by one.
  4507.  
  4508.    * *Move right*
  4509.  
  4510.      Moves the current column right by one.
  4511.  
  4512.    * *Insert Column*
  4513.  
  4514.      Inserts a new column.
  4515.  
  4516.    * *Clear Column*
  4517.  
  4518.      To clear a column, it is *not* sufficient to set its weight to
  4519.      `0'! If you want to clear a column, you have to select the desired
  4520.      column (using the `Column' gadget) and then hit the `Clear column'
  4521.      gadget.
  4522.  
  4523.      Please notice that "empty" columns are *not* possible! Only the
  4524.      columns in front of the first cleared column are displayed.
  4525.  
  4526.      Example:
  4527.  
  4528.           You have set the columns 1,2,3 and 4 to the fields `Name',
  4529.           `FirstName', `Phone' and `Town'. If you clear column 3
  4530.           (`Phone') and select `Ok', only columns 1 and 2 (`Name' und
  4531.           `FirstName') are still visible.
  4532.  
  4533.  
  4534.    * *Ok and Cancel*
  4535.  
  4536.      With `Ok' you accept the changes you've done; if the *DFA-Editor*
  4537.      is currently running, the changes are applied to it and are
  4538.      visible at once. `Cancel' discards the changes.
  4539.  
  4540. This all may have sounded a bit complicated, so I'll give you an
  4541. example that shall make clear in a step by step procedure, how to
  4542. configure your "own" format for the address listview:
  4543.  
  4544.      Let's say, you want the following format of the listview's lines:
  4545.  
  4546.  
  4547.           <First Name> <Name> <Phone> <Group Flags>
  4548.           
  4549.               30%        30%    40%        ---
  4550.  
  4551.      ...then you should do like this:
  4552.  
  4553.      Click on the `Columns' gadget until `Column 1' is shown.  Now
  4554.      select `First name' in the `Fields' listview and enter `30' into
  4555.      the `Weight' string gadget. Click once on the `Columns' gadget --
  4556.      `Column 2' appears. Select `Name' in the `Fields' listview and
  4557.      enter `30' into the `Weight' string gadget. Click on the `Columns'
  4558.      gadget once again -- `Column 3' appears -- and select `Phone' from
  4559.      the `Fields' listview. Please enter `40' into the `Weight' string
  4560.      gadget. One more click on the `Columns' gadget brings `Column 4'
  4561.      to front. Now select `Group flags' from the `Fields' listview.
  4562.      Please notice that the `Weight' gadget is displayed "ghosted" now
  4563.      and, therefore, no input into this gadget is possible; this is not
  4564.      needed either, as the group flags always need eight characters.
  4565.      Please click on the `Columns' gadget one more time to make `Column
  4566.      5' visible. Select `Clear column' to make sure that the 5th column
  4567.      is "clear". Hit `Ok' to make the changes active -- if the
  4568.      *DFA-Editor* program is currently running, all changes will be
  4569.      visible at once.
  4570.  
  4571.  
  4572. Panel Listview
  4573. ==============
  4574.  
  4575. Below the address listview of the *DFA-Editor* main window, there is
  4576. another listview called "Panel listview". This is used to make further
  4577. information about the current address visible. It is possible to
  4578. display up to 16 lines. Every line can display any field of the
  4579. address; the line title may be changed as well.
  4580.  
  4581. Furthermore, it is possible to adjust the number of lines that are
  4582. visible at a time.
  4583.  
  4584.    * *Lines*
  4585.  
  4586.      Every click on the `Lines' cycle gadget makes the next line number
  4587.      visible (`Line 1' through `Line 16'). After the last line number
  4588.      (16) `Line 1' is displayed again.
  4589.  
  4590.    * *Fields*
  4591.  
  4592.      This listview corresponds to the one you  got to know in
  4593.      PrefsAList. Using this listview, you may select which field of the
  4594.      particular address you want to get displayed in the currently
  4595.      selected line (cf. `Lines').
  4596.  
  4597.    * *Title*
  4598.  
  4599.      It is possible to give any line title you like; for example `Phone
  4600.      #:' for the `Phone' field or `Groups:' for the `group selection'.
  4601.  
  4602.      If you want e.g. that all three email address are displayed among
  4603.      one another (i.e. Line 1 through line 3), it could be a good idea
  4604.      to give the first line (`EMail 1') the title `EMail:' and leave
  4605.      line 2 and line 3 without a line title.
  4606.  
  4607.    * *Move up*
  4608.  
  4609.      Moves the current line up by one.
  4610.  
  4611.    * *Move down*
  4612.  
  4613.      Moves the current line down by one.
  4614.  
  4615.    * *Insert line*
  4616.  
  4617.      Inserts a line.
  4618.  
  4619.    * *Clear line*
  4620.  
  4621.      Similarly to PrefsAList (see `Clear Column') it is needed here as
  4622.      well to explicitly delete lines you don't want to use any longer.
  4623.      Please notice that only lines in front of the first "cleared" line
  4624.      are displayed, even if there are lines with contents behind the
  4625.      first cleared line. This means that empty lines are not possible.
  4626.  
  4627.    * *Visible lines*
  4628.  
  4629.      It is possible (within certain values) to change the size of the
  4630.      panel listview using this slider gadget. You may have up to 12
  4631.      lines visible at a time! Please notice that the *DFA-Editor*
  4632.      reduces the number of visible lines automatically, if there is not
  4633.      enough space for the desired listview lines in the window.
  4634.  
  4635.    * *Ok and Cancel*
  4636.  
  4637.      Using `Ok' you accept the changes and a currently running
  4638.      *DFA-Editor* program is updated at once. `Cancel' discards the
  4639.      changes.
  4640.  
  4641. The following example may help you to understand the `Panel' listview
  4642. configuration more easily:
  4643.  
  4644.      Let's say you would like to get the following format in your
  4645.      `Panel' listview
  4646.  
  4647.  
  4648.                    <Title>    <Contents>
  4649.           <Line 1> EMail:     [EMail 1]
  4650.           <Line 2>            [EMail 2]
  4651.           <Line 3> Comment:   [Comment]
  4652.  
  4653.      Terms between the `[' and `]' brackets describe field names, terms
  4654.      between `<' and `>' brackets serve as description.
  4655.  
  4656.      First click on the `Lines' cycle gadget, until `Line 1' appears
  4657.      (after the window has opened `Line 1' is usually visible already).
  4658.      Now select `EMail 1' from the `Fields' listview and enter `EMail:'
  4659.      into the `Title' string gadget.  Now click on the `Lines' gadget
  4660.      once -- `Line 2' should become visible. Select `EMail 2' from the
  4661.      `Fields' listview and delete the contents of the `Title' string
  4662.      gadget, if it isn't empty already. One more click on the `Lines'
  4663.      gadget brings `Line 3' to front. Select `Comment' from the `Lines'
  4664.      listview and enter `Comment' into the `Title' string gadget.
  4665.      After one more click on the `Lines' gadget, please click on the
  4666.      `Clear line' gadget to delete line four, if it isn't empty. Hit
  4667.      `Ok' to accept the changes. If the *DFA-Editor* is currently
  4668.      running, the changes will be made visible at once.
  4669.  
  4670.  
  4671. Groups
  4672. ======
  4673.  
  4674. First of all, a few words about the group flags and their purpose and
  4675. meaning:
  4676.  
  4677.      It is possible to separate your addresses into groups and set the
  4678.      different group flags for every address item. Let's say you're
  4679.      using the first three (out of a maximum of eight) group flags and
  4680.      you've named them `Private', `Business' and `Other' (see
  4681.      PrefsGroups, for more information).
  4682.  
  4683.      Now you can set the `Private' flag to all private addresses, the
  4684.      `Business' flag to all business related addresses, and the `Other'
  4685.      flag to all address that don't belong to any of these groups. Of
  4686.      course, you may set more than one flag at a time, if an address is
  4687.      a private one and business related as well, for example.
  4688.  
  4689.      In the main window of the *DFA-Editor* you can select the groups
  4690.      you would like to see within the address listview (or use the
  4691.      AREXX command `CHANGEGROUPS' accordingly). If you want to see the
  4692.      private and the business addresses, activate both checkbox
  4693.      gadgets. Please notice that all actions, for instance, printing
  4694.      and searching are performed on the active (i.e. displayed)
  4695.      addresses only!
  4696.  
  4697.      In the `Groups' window of the *DFA-Preferences* (cf.  PrefsGroups)
  4698.      you may set which kind of relation between the groups you like. If
  4699.      you have activated more than one group at the same time (in the
  4700.      example above `Private' and `Other'), you may select either the
  4701.      relation `via 'OR'' or the relation `via 'AND'':
  4702.  
  4703.         * *via 'OR'*
  4704.  
  4705.           Every address that has at least one of the wanted flags set,
  4706.           is displayed. If you activate `Private' and `Other', all
  4707.           addresses will be displayed that have either set the `Private'
  4708.           *or* the `Other' flag *or* both flags.
  4709.  
  4710.         * *via 'AND'*
  4711.  
  4712.           Only those addresses are shown that have set at least the
  4713.           groups you selected in the *DFA-Editor* main window. If the
  4714.           `Private' and the `Other' flags are both set, only addresses
  4715.           will be shown that have at least the `Private' *and* the
  4716.           `Other' flag set; addresses that have set only one of these
  4717.           flags are *not* shown.
  4718.  
  4719.      Groups that don't have any group flags set can be made visible by
  4720.      deselecting all the group flags in the *DFA-Editor* main window
  4721.      (i.e. all check boxes are "empty").
  4722.  
  4723.  
  4724. Let's shift to the settings that are possible here:
  4725.  
  4726.    * *Groups*
  4727.  
  4728.      This cycle gadget allows you to set the group (`Group~1' through
  4729.      `Group~8') you want to modify.
  4730.  
  4731.    * *Title*
  4732.  
  4733.      The name of the group can be entered into this string gadget. The
  4734.      desired keyboard shortcut has to be marked with a leading
  4735.      underscore (`_'), for example:
  4736.  
  4737.  
  4738.           Group _1        The group's name is `Group 1', its
  4739.                           shortcut is the digit `1'
  4740.           
  4741.           Pri_vate        `Private' is used for the group name, the
  4742.                           keyboard shortcut is the `v'
  4743.           
  4744.           Other (_3)      `Other (3)' is the group's name, the digit `3'
  4745.                           its keyboard shortcut
  4746.  
  4747.           *Please notice:*
  4748.  
  4749.           Even if it *is* possible to use any keyboard shortcut you
  4750.           like, as long as it is a usual letter, you should remember
  4751.           that *DFA* does not check if the keyboard shortcut you enter
  4752.           is unique within the *DFA* application. Therefore, you have
  4753.           to make sure by yourself that the keyboard shortcuts you want
  4754.           to use are not being used by other gadgets.
  4755.  
  4756.           Please notice as well that the shortcut for the different
  4757.           groups are not only used within the *DFA-Editor* main window,
  4758.           but have to be unique in e.g. the *DFA-Editor* `Edit' window
  4759.           as well.
  4760.  
  4761.           The shortcuts which are guaranteed to be unique within the
  4762.           complete *DFA* application are the digits `1' through `8',
  4763.           which is the default as well.
  4764.  
  4765.  
  4766.  
  4767.      The length of the group titles is limited to 15 digits to make sure
  4768.      that no title overwrites the window contents and/or border.
  4769.  
  4770.    * *Group handling*
  4771.  
  4772.      This cycle gadget allows you to select the kind of relation of
  4773.      several group flags (see above for details).
  4774.  
  4775.    * *Ok and Cancel*
  4776.  
  4777.      After you hit `Ok', the changes become active. If you hit `Cancel'
  4778.      instead, all changes are lost.
  4779.  
  4780. Fonts
  4781. =====
  4782.  
  4783. The fonts that shall be used by the *DFA-Editor* and the
  4784. *DFA-Preferences* program can be set in this window. If you don't
  4785. change the default setting (`Use System Font' for every font),  all
  4786. program parts use the fonts you set in the Font Preferences program of
  4787. the Workbench. Alternatively, you may set any font you like for each of
  4788. the four fonts used.
  4789.  
  4790.    * *DFA-Editor*: Gadget font
  4791.  
  4792.      Here you may enter the font, which is used for the gadget texts of
  4793.      the *DFA-Editor*.
  4794.  
  4795.    * *DFA-Editor*: List font
  4796.  
  4797.      For the different listviews of the *DFA-Editor* a seperate font
  4798.      may be chosen. Please notice that only non-proportional fonts are
  4799.      allowed here.
  4800.  
  4801.    * *Same as Editor*
  4802.  
  4803.      If you want to use the same fonts for the *DFA-Preferences*
  4804.      program as for the *DFA-Editor*, just push this button.
  4805.  
  4806.    * *DFA-Preferences*: Gadget font
  4807.  
  4808.      see above, *DFA-Editor*: Gadget font.
  4809.  
  4810.    * *DFA-Preferences*: List font
  4811.  
  4812.      see above, *DFA-Editor*: List font. Please notice, however, that
  4813.      even proportional fonts are allowed here!
  4814.  
  4815. Modem
  4816. =====
  4817.  
  4818. The settings set here only have meaning if you have a modem connected
  4819. to your computer and plan to use *DFA* to dial the stored phone numbers.
  4820.  
  4821. Furthermore you should have a phone connected to your modem!
  4822.  
  4823. The following settings may be changed:
  4824.  
  4825.    * *Baud*
  4826.  
  4827.      This cycle gadget may be used to set the baud rate of the serial
  4828.      port.  As the serial port is only used to send command sequences
  4829.      and not to transfer real data, the baud rate doesn't really
  4830.      matter; however, it should not be higher than the baud rate, your
  4831.      modem supports (default: `1200').
  4832.  
  4833.    * *Init String*
  4834.  
  4835.      The string that you enter into this string gadget is used to
  4836.      initialize the modem. If you have a modem that supports the
  4837.      "Hayes" command sequences, the init command is usually `ATZ'
  4838.      (default: `ATZ~~~').
  4839.  
  4840.    * *Hangup String*
  4841.  
  4842.      The string that is to be used to hang up the line, i.e. to
  4843.      terminate the connection, may be entered here (default:
  4844.      `+++\rTH0\r')
  4845.  
  4846.    * *Predial String*
  4847.  
  4848.      This string is sent to the modem just before the phone number
  4849.      itself.  Some examples for "Hayes" compatible modems:
  4850.  
  4851.              ATDP            Pulse dial (default)
  4852.              ATDT            Tone dial
  4853.              ATX3DP#WP       Makes the modem wait for a dialtone after
  4854.                              sending a number (`#'). So it is possible
  4855.                              to call from a extension line.
  4856.                              Just substitute `#' by the number you would
  4857.                              usually enter to get a dialtone.
  4858.  
  4859.    * *Suff. Dial String*
  4860.  
  4861.      The string that has to be sent just after the phone number may be
  4862.      entered here. Please notice that this string has to be *at least*
  4863.      a `\r', as the dialing does not work otherwise (default: `\r').
  4864.  
  4865.    * *Serial device*
  4866.  
  4867.      Here you may enter the name of a serial device that shall be used
  4868.      for dialing.  Usually this is the Commodore `serial.device', which
  4869.      is the default.  If you have an interface card with (an)
  4870.      additional serial interface(s), you can insert the new serial
  4871.      device here.
  4872.  
  4873.    * *Select device*
  4874.  
  4875.      Instead of typing the name of the serial device you can comfortably
  4876.      select it from a file requester. The selected device is inserted
  4877.      into the `Serial device' field.
  4878.  
  4879.    * *Device unit*
  4880.  
  4881.      You may enter the number of the serial device here. Usually this is
  4882.      `0'. However, if you have an interface card with more than one
  4883.      serial port, they are distinguishable by their numbers (`0' and
  4884.      `1' for example).
  4885.  
  4886.    * *Retries*
  4887.  
  4888.      If a line is busy, it is possible to tell *DFA* to retry; the
  4889.      number of retries may be entered here.
  4890.  
  4891.    * *Redial delay*
  4892.  
  4893.      The time delay between two dial events.
  4894.  
  4895.    * *Use OwnDevUnit*
  4896.  
  4897.      The `OwnDevUnit.library' gives you the chance to use *DFA* for
  4898.      dialing, even if the serial port is permanently occupied by a
  4899.      program as the `getty' for example. The requirement for this to
  4900.      work is that this program supports the `OwnDevUnit.library' as
  4901.      well of course. If you don't use such a program, you may deactivate
  4902.      the `Use OwnDevUnit' checkbox. If there is no `OwnDevUnit.library'
  4903.      installed on your computer, it can't be used of course.
  4904.  
  4905. The input you can do into `Init String', `Hangup String',
  4906. `PredialString' and `Suff. Dial String', can be found in the manual of
  4907. your modem. In addition to the strings listed there, *DFA* supports the
  4908. following command sequences:
  4909.  
  4910.    * *`~' (Tilde)*
  4911.  
  4912.      Causes a delay of about one second.
  4913.  
  4914.    * *`\b' (Backspace)*
  4915.  
  4916.      Deletes the character to its left.
  4917.  
  4918.    * *`\f' (Formfeed)*
  4919.  
  4920.      Performs a form feed.
  4921.  
  4922.    * *`\n' (Linefeed)*
  4923.  
  4924.      Produces a line feed.
  4925.  
  4926.    * *`\r' (Carriage return)*
  4927.  
  4928.      Performs a carriage return.
  4929.  
  4930.    * *`\t' (Tab)*
  4931.  
  4932.      Inserts a `Tab' character.
  4933.  
  4934.    * *`\e' (ESC)*
  4935.  
  4936.      Inserts an `Escape' character.
  4937.  
  4938. Paths and Filenames
  4939. ===================
  4940.  
  4941. The file and pathnames used by *DFA* may be set here.
  4942.  
  4943. More comfortable than to enter the pathname into the string gadgets
  4944. manually is to hit the button just behind the corresponding string
  4945. gadget. If you do so, a file requester pops up and you may select the
  4946. desired file or pathname.
  4947.  
  4948.    * *Address file*
  4949.  
  4950.      This is the address file that is loaded automatically during the
  4951.      startup of *DFA* (default: `s:adr.file'). This filename will be
  4952.      used as well, if you select `Save as default'.
  4953.  
  4954.    * *External files*
  4955.  
  4956.      The external files are saved in a directory of their own (default:
  4957.      `s:DFAExternals').
  4958.  
  4959.    * *File editor*
  4960.  
  4961.      To modify the external files, you need an ASCII editor. The `ed',
  4962.      which can usually be found in the `C:' drawer of your workbench,
  4963.      is an appropriate tool for example (default: `ed').
  4964.  
  4965.    * *File viewer*
  4966.  
  4967.      To view the external files, you need a text viewer, as for example
  4968.      the `more' program that comes along with your Workbench programs
  4969.      (default: `more').
  4970.  
  4971. Arexx Scripts
  4972. =============
  4973.  
  4974. It is possible to bind one AREXX script to any function key (`F1'
  4975. through `F10') and any "shifted" function key (`SHIFT F1' through
  4976. `SHIFT F10'). You may toggle between the 2 function key blocks using
  4977. the `Qualifier' cycle gadget.
  4978.  
  4979. If you don't like to enter the name of the AREXX script (including its
  4980. path) by hand, you may alternatively hit the button gadget just behind
  4981. the corresponding string gadget (keyboard shortcut: `SHIFT' `<digit>').
  4982. If you do so, a file requester will pop up and the desired AREXX script
  4983. can be selected.
  4984.  
  4985. The AREXX scripts you enter here can only be reached via the function
  4986. keys from the main window of the *DFA-Editor*. In the `rexx' drawer of
  4987. the *DFA* distribution, some example scripts can be found; all files
  4988. suited for this purpose have the extension `.dfa'.
  4989.  
  4990. Into `Template script' you may enter the AREXX script, you want to use
  4991. together with the `New' function to change the template address. `Use
  4992. script' toggles the usage of this script on or off respectively.
  4993.  
  4994. The `Postprocess script' field may be used to enter an AREXX script,
  4995. which is executed after a new address has been entered. `Use p.process
  4996. script' toggles this script on or off.
  4997.  
  4998. Hit `Ok' to accept the changes or `Cancel' to quit the window and
  4999. discard the changes.
  5000.  
  5001. Sorting
  5002. =======
  5003.  
  5004. The addresses can be sorted by (nearly) every field of an address.  To
  5005. manage this, you may enter up to four sort criteria here. The most
  5006. important one is `Sort criteria 1'. If two addresses can't be
  5007. distinguished by this criteria alone (e.g. if there are identical
  5008. names), the second sort criteria (`Sort criteria 2') is used. If a
  5009. distinction is still impossible, the third sort criteria is used and so
  5010. on.
  5011.  
  5012.    * *Sort*
  5013.  
  5014.      Here you may choose which sort criteria you would like to change.
  5015.  
  5016.    * *Fields*
  5017.  
  5018.      You may select one address field from this listview for every sort
  5019.      criteria (`Sort criteria 1' through `Sort criteria 4').
  5020.  
  5021.    * *Clear sort criteria*
  5022.  
  5023.      If you want to delete a sort criteria, please hit this button.
  5024.  
  5025.    * *Ok and Cancel*
  5026.  
  5027.      `Ok' accepts the changes. Please notice that the addresses are
  5028.      *not* resorted automatically. To sort your addresses using the
  5029.      modified sort criteria, you have to explicetly select `Sort' in
  5030.      the *DFA-Editor* (or use the corresponding AREXX command).
  5031.      `Cancel' ignores the changes.
  5032.  
  5033. Custom Screens
  5034. ==============
  5035.  
  5036. It is possible ot let *DFA* open its own custom screens. As long as you
  5037. don't use this feature, *DFA* opens up on existing public screens. This
  5038. behaviour can be customized by using the corresponding Tool Types.
  5039.  
  5040. Custom screens can be set for the *DFA-Editor* and for the *DFA-Prefs*
  5041. program seperately.
  5042.  
  5043. Custom Screen (*DFA-Editor*)
  5044. ----------------------------
  5045.  
  5046.    * Use custom screen
  5047.  
  5048.      Toggles the usage of a custom screen.
  5049.  
  5050.    * Screen mode
  5051.  
  5052.      Displayes the selected screen mode. The button which is can be
  5053.      found behind the text gadget activate the screen mode requester.
  5054.  
  5055.    * Screen title
  5056.  
  5057.      Title of the cusom screen.
  5058.  
  5059.    * Screen font
  5060.  
  5061.      The font for the custom screen. The button gadget behind the text
  5062.      gadget activates the font requester.
  5063.  
  5064. Custom Screen *DFA-Preferences Program*
  5065. ---------------------------------------
  5066.  
  5067.    * Use custom screen
  5068.  
  5069.      See PrefsScreenEditor
  5070.  
  5071.    * Same as Editor
  5072.  
  5073.      The *DFA-Preferences* program uses the same custom screen as the
  5074.      *DFA-Editor*.
  5075.  
  5076.    * Screen mode
  5077.  
  5078.      See PrefsScreenEditor
  5079.  
  5080.    * Screen title
  5081.  
  5082.      See PrefsScreenEditor
  5083.  
  5084.    * Screen font
  5085.  
  5086.      See PrefsScreenEditor
  5087.  
  5088. Legal stuff
  5089. ***********
  5090.  
  5091. Licence
  5092. =======
  5093.  
  5094.   1. This licence applies to the product called `DFA', a package for
  5095.      the *AMIGA* computer, published by Dirk Federlein under the
  5096.      concepts of *Shareware*. The terms "Package", "*DFA*" and
  5097.      "Archive" refer to this product. The licensee is addressed as
  5098.      "you".  This license does not apply to third party supplied
  5099.      programs, found e.g. in the `c' or `libs' drawer of the original
  5100.      distribution archive.
  5101.  
  5102.   2. You may use *DFA* for a period of up to 21 days for evaluation.
  5103.      After that, you have to register.
  5104.  
  5105.   3. This archive may be freely redistributed only *without the
  5106.      keyfile*, which you got from me when you have registered. Please
  5107.      remember that the keyfile contains your name to prevent you from
  5108.      giving it away to others.
  5109.  
  5110.   4. You are *not allowed* to draw commercial profit out of
  5111.      distributing this package. You may charge a fee to recover
  5112.      distribution and copy costs. The fee for diskette distribution may
  5113.      *not be more* than the cost to obtain a public domain diskette
  5114.      from Fred Fish.
  5115.  
  5116.   5. You are *not* allowed to manipulate any file of *DFA* and
  5117.      distribute it under any or no name. Compression with common
  5118.      archivers like `zoo' or `lharc' is allowed. You are only allowed to
  5119.      redistribute the *whole* original archive (*without* the keyfile
  5120.      however).
  5121.  
  5122.      Some files *may be* modified for your personal use:
  5123.  
  5124.         * The AREXX scripts
  5125.  
  5126.           The example AREXX scripts which can be found in the `Rexx'
  5127.           drawer of the original distribution may be modified and/or
  5128.           enhanced.
  5129.  
  5130.         * The LOCALE files
  5131.  
  5132.           If you adopt the catalog translation files (extension `.ct'),
  5133.           you will be able to translate all program texts of *DFA* into
  5134.           your native language.
  5135.  
  5136.      If you do such changes, you may do so for your personal use;
  5137.      redistribution of modified files is not allowed.  (Nevertheless
  5138.      the author would be happy, if you'd sent him your modified files,
  5139.      so that they may serve as a basis for an inclusion into future
  5140.      versions of *DFA*)
  5141.  
  5142.   6. If developers of commercial software would like to include certain
  5143.      parts of *DFA* in their commercial products, they will have to
  5144.      contact the author of *DFA* first, to ask for permission.
  5145.  
  5146.   7. You agree to cease distributing *DFA* if requested to do so by the
  5147.      author.
  5148.  
  5149.   8. By copying, distributing and/or using *DFA* you indicate your
  5150.      acceptance of this license to do so, and all its terms and
  5151.      conditions.
  5152.  
  5153.   9. Each time you redistribute this package, the recipient
  5154.      automatically receives a license from the original licensor to
  5155.      copy, distribute and/or use this package subject to these terms
  5156.      and conditions.  *You may not impose any further restrictions on
  5157.      the recipients' exercise of the rights granted herin*.
  5158.  
  5159.  10. As always, Fred Fish has got explicit permission to include this
  5160.      package into his wonderful "Fish Disk" collection, no matter if it
  5161.      is on floppy or compact disk.
  5162.  
  5163.  
  5164. Warranty
  5165. ========
  5166.  
  5167. This software is provided *as is* without warranty of any kind, either
  5168. expressed or implied. By using *DFA*, you agree to accept the entire
  5169. risk as to the quality and performance of this package.
  5170.  
  5171. In no event (unless required by applicable law or agreed to in writing)
  5172. will any copyright holder, or any other party who may redistribute this
  5173. package as permitted above, be liable to you for damages, including any
  5174. general, special, incidental or consequential damages arising out of the
  5175. use or inability to use this package (including but not limited to loss
  5176. of data or data being rendered inaccurate or losses sustained by you or
  5177. third parties), even if such holder or other party has been advised of
  5178. the possibility of such damages.
  5179.  
  5180. Of course, *DFA* has been tested rather extensively before it was
  5181. released. In case you find any bugs in *DFA* I please you to send me a
  5182. bug report. See Bugreports.
  5183.  
  5184. Copyright
  5185. =========
  5186.  
  5187. GUI created using Gadtoolsbox (37.300) (C) 1991-93 Jan van den Baard.
  5188.  
  5189. AREXX interface created using Arexxbox (V1.12) (C) 1992-93 Michael
  5190. Balzer.
  5191.  
  5192. The MagicWB icons are (C) Copyright 1993-94 Martin Huttenloher
  5193.  
  5194. Installer and Installer project icon (C) Copyright 1991-93
  5195. Commodore-Amiga, Inc.  All Rights Reserved.  Reproduced and distributed
  5196. under license from Commodore.
  5197.  
  5198. INSTALLER SOFTWARE IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO
  5199. WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY OR
  5200. RESPONSIBILITY IS ASSUMED.
  5201.  
  5202. Registered trademarks are *not* marked separately.  Therefore absence
  5203. of a trademark does not imply they are free.
  5204.  
  5205. Registration
  5206. ************
  5207.  
  5208. Since Version 2.1 of *DFA* has been finished, it is an product with the
  5209. *SASG* quality brand.
  5210.  
  5211. The advantages, which grow out of this can be looked up within the
  5212.  
  5213. @{" Registration/Information " system DFA:C/Registration} program.
  5214.  
  5215. Information about registration sites, the *SASG*, the shareware fee,
  5216. payment methods etc. can be found there as well.
  5217.  
  5218. The registration program can be started either seperately or directly
  5219. out of the about requester of *DFA*.
  5220.  
  5221. Before you register, you have the opportunity to test `DFA' in great
  5222. detail.  However, when using the unregistered version you can't save
  5223. the preferences (this feature is disabled); all changes you perform
  5224. using the *DFA-Preferences* program stay active only until you reboot
  5225. your computer. The window positions are therefore *not* saved as well.
  5226.  
  5227. In spite of all this restrictions it should be possible to see if *DFA*
  5228. is what you expect. As soon as you use `DFA' regularly, however not
  5229. later than after 21 days, you have to register!
  5230.  
  5231. You'll get your personal keyfile, a TeX manual (in German *and*
  5232. English) and an AMIGAGUIDE manual (German *and* English). All manual
  5233. files are on the disk only and *not* printed!
  5234.  
  5235. You'll find my address below, see Addresses.
  5236.  
  5237. Updates
  5238. *******
  5239.  
  5240. I'm continuously working on *DFA* and I'll publish updates from time to
  5241. time. These updates will be fed into the following electronic nets:
  5242.  
  5243.    * ADS Filenet
  5244.  
  5245.    * AmiNet FTP Server
  5246.  
  5247. If you have access to such a electronic net, you can get the latest
  5248. version of *DFA* quickly and cheaply. Many electronic mailboxes supply
  5249. the latest version of *DFA* as well, e.g.
  5250.  
  5251. *Publisher's Treff*
  5252.      SASG Support BBS - All SASG products available
  5253.      63739 Aschaffenburg
  5254.      Tel.: Germany-(0)6028-996886
  5255.      Fido: 2:244/6302.0
  5256.      You may get the latest version of *DFA* off from that `BBS' via
  5257.      Fido-FileRequest. The magic for the FileRequest is `DFA'. Any
  5258.      other *SASG* product may be requested as well.
  5259.  
  5260. *Incubus*
  5261.      97074 Würzburg
  5262.      Tel.: Germany-(0)931-781464, -781465, -781467, -781468, -72695,
  5263.      -884703, -884726
  5264.  
  5265. Alternatively you may order your update directly from me. Please use
  5266. the registration program for this purpose -- as you've already done
  5267. when you've registered.
  5268.  
  5269. Fred Fish will get *DFA* to include it in his library. However, it will
  5270. last a few weeks until `DFA' finds its was on these floppy or compact
  5271. disks respectively.
  5272.  
  5273. Bug Reports
  5274. ***********
  5275.  
  5276. In spite of the fact that every release version is tested very
  5277. thoroughly before it is published, I can't guarantee that there are no
  5278. more bugs in it.
  5279.  
  5280. This fact can be understood more easily, if you know that the source
  5281. code of *DFA* takes up about 2 MB up to now!
  5282.  
  5283. So I ask you to report any bugs you discover.  If you have any ideas
  5284. what should be improved in future versions of *DFA*, please feel free
  5285. to write, (mail or email, doesn't matter) giving me any suggestions.
  5286.  
  5287. Bug reports can be sent by ordinary or elecronic mail. The address can
  5288. be found in Addresses.
  5289.  
  5290. Important Addresses
  5291. *******************
  5292.  
  5293. The author's address
  5294. ====================
  5295.  
  5296. *Home address:*
  5297.      Dirk Federlein
  5298.      Brunnengasse 11a
  5299.      63741 Aschaffenburg
  5300.      Germany
  5301.  
  5302. *Study address:*
  5303.      Dirk Federlein
  5304.      Am Sonnenberg 34
  5305.      97078 Würzburg
  5306.      Germany
  5307.  
  5308. *E-Mail:*
  5309.      UUCP: dirkf@alcmy.franken.de
  5310.      CIS: 100577,1027
  5311.      FIDO: 2:244/6302.12
  5312.  
  5313. E-mail reaches me always, no matter to which of the above addresses you
  5314. write. If you prefer to send "normal" mail, you should send it to
  5315. Aschaffenburg.
  5316.  
  5317. *Bank address:*
  5318.      Bayerische Vereinsbank Aschaffenburg
  5319.      Sort code: 795 200 70
  5320.      Account: 160 6 140
  5321.      Germany
  5322.  
  5323. Registration in Belgium
  5324. =======================
  5325.  
  5326. *Olivier Toebosch*
  5327.      Kapittelstraat 19
  5328.      2610 Wilrijk
  5329.      Belgium
  5330. *E-Mail:*
  5331.      FIDO: 2:292/603.21
  5332. *Bank account:*
  5333.      Account: 403-4132721-12
  5334.      Belgium
  5335. Registration in England
  5336. =======================
  5337.  
  5338. *Paul Jewell*
  5339.      7 Fairfield Avenue
  5340.      Victoria Park
  5341.      Cardiff
  5342.      Great Britain (Wales)
  5343. *E-Mail:*
  5344.      UUCP: Paul_Jewell@savanna.exnet.com
  5345. *Bank account:*
  5346.      Lloyds Bank
  5347.      Sort code: 30-98-94
  5348.      Account: 7574426
  5349. Registration in France
  5350. ======================
  5351.  
  5352. *Etienne Schneider*
  5353.      1 impasse des Sans Boutons
  5354.      F-80000 Amiens
  5355.      France
  5356. *E-Mail:*
  5357.      UUCP: etienne.schneider@ramses.fdn.org
  5358. Registration in Germany
  5359. =======================
  5360.  
  5361. *Christoph Reichert*
  5362.      Im Hag 2
  5363.      63834 Sulzbach am Main
  5364.      Deutschland
  5365. *E-Mail:*
  5366.      UUCP: chris@ptreff.ab.mayn.sub.de
  5367.      FIDO: 2:244/6302.0
  5368. *Bank address:*
  5369.      Sparkasse Aschaffenburg - Alzenau
  5370.      Sort code: 795 500 00
  5371.      Account: 528 01 77
  5372.      Germany
  5373.  
  5374. Registration in Sweden
  5375. ======================
  5376.  
  5377. *AUGS Shareware Center*
  5378.      c/o Nilsson, Färgargränd 35
  5379.      S-831 51  Östersund
  5380.      Sweden
  5381. *E-Mail:*
  5382.      UUCP: augssc@augs.se
  5383.      FIDO: 2:204/404.888
  5384. Registration in the USA
  5385. =======================
  5386.  
  5387. *Robert Blayzor*
  5388.      PO Box 807
  5389.      Johnstown, NY 12095-0807
  5390.      U.S.A.
  5391. *E-Mail:*
  5392.      UUCP: die@lsd.org
  5393. Internal
  5394. ********
  5395.  
  5396. Locale Support
  5397. ==============
  5398.  
  5399. While *DFA* V1.2x supported seven different languages, version 2.0 of
  5400. *DFA* comes along only with english and german language support. This
  5401. restriction has several reasons:
  5402.  
  5403.   1. The english and german version of the catalog files can be done by
  5404.      myself. Therefore I am no longer -- especially when creating
  5405.      updates -- forced to get updated locale files from many different
  5406.      parts of this world *in time*.
  5407.  
  5408.   2. For version 2.0 of *DFA* I enlarged the locale files by a big
  5409.      amount. To translate these files is a lot of work that I don't
  5410.      want to be done by other people than by myself.
  5411.  
  5412.   3. The enormous effort to adopt the locale files (for updates),
  5413.      prevented me a long time from doing a major update at all. Please
  5414.      notice that all locale files have to be changed, even if I add
  5415.      only one single sentence or word! Now there is no longer such a
  5416.      reason (for me) to delay updates!
  5417.  
  5418.   4. The number of registered users that prefer other languages than
  5419.      german or english is still quite low. This has been the reason not
  5420.      to put a french locale into *DFA* V1.2x, as in the beginning there
  5421.      was no registered french user at all. Furthermore -- most people
  5422.      prefer the english program texts even if English isn't their
  5423.      native language.
  5424.  
  5425.  
  5426. Since version 2.1 has been finished, the french program texts are
  5427. available as well!
  5428.  
  5429. The CheckBirthday Program
  5430. =========================
  5431.  
  5432. Since *DFA* got its Arexx-Port, it comes along with an Arexx script
  5433. that displays coming birthdays. This script had, besides several pros,
  5434. one real con: It needed much time to process a (long) address list.
  5435.  
  5436. Out of this reason *DFA* now comes along with an addition tool that does
  5437. the same job, but much faster.
  5438.  
  5439. It can be started out of the shell, with the command:
  5440.  
  5441.  
  5442.      CheckBirthday ADR=ADRESSFILE/A BEFORE=DAYSBEFORE/N
  5443.                    AFTER=DAYSAFTER/N DELAY/N
  5444.  
  5445. The meaning of the different parameters:
  5446.  
  5447. `ADDRESSFILE'
  5448.      The address database file
  5449.  
  5450. `BEFORE'
  5451.      Number of days before the birthday
  5452.  
  5453. `AFTER'
  5454.      Number of days after the birthday
  5455.  
  5456. `DELAY'
  5457.      Delay in seconds after the output of all birthdays
  5458.  
  5459. Starting from Workbench is possible as well! Please notice that you
  5460. have to make sure that you have adjusted the tooltypes to your needs.
  5461. These tooltypes have the same names as the shell parameter.
  5462. Additionally the `WINDOW' tooltype is available that gives you the
  5463. chance to set the output window position and size, like:
  5464.  
  5465.  
  5466.      WINDOW=CON:20/20/400/200/Geburtstage/AUTO/CLOSE/WAIT
  5467.  
  5468. Needed Configuration
  5469. ********************
  5470.  
  5471. The minimum configuration for the usage of *DFA* consists of any
  5472. *AMIGA* computer that runs at least *AMIGA-OS 2.0* and 1 MB RAM.
  5473.  
  5474. As the addresses are completely kept in RAM, as more you have as better
  5475. it is.
  5476.  
  5477. A harddisk is not needed, but recommended. If you don't have a
  5478. harddisk, you should posses at least two disk drives and make sure that
  5479. your boot disk still has enough free space.
  5480.  
  5481. If you run (at least) Workbench 2.1 on your system, you may change the
  5482. native language if you like (use the Locale preferences program of the
  5483. Workbench to do so).
  5484.  
  5485. If you run version 3.x of the operating system, you can enjoy some
  5486. additional (mostly optical) features of this OS version.
  5487.  
  5488. Hints and Tips
  5489. **************
  5490.  
  5491. Question:
  5492.      After I restarted the computer, *DFA* has "forgotten" all window
  5493.      positions I'd adjusted before -- why?
  5494.  
  5495. *Answer:*
  5496.      To save the window positions, you have to save the *DFA*
  5497.      preferences. This can be done for example by selecting the
  5498.      appropriate menu item (`Settings->Save Preferences') of the
  5499.      *DFA-Editor*.
  5500.  
  5501.      Please remember that the settings, and as a consequence of this,
  5502.      the window positions as well, can only be saved in the registered
  5503.      version of *DFA* (see Registration, for details).
  5504.  
  5505. Question:
  5506.      After I entered another position for the application icon, it
  5507.      stayed on the same place as before.
  5508.  
  5509. *Answer:*
  5510.      Click on the `Show' check box gadget in the Miscellaneous Window
  5511.      of the *DFA-Preferences* program (cf. PrefsMisc) *twice*. Now the
  5512.      application icon should appear on the desired position, as long as
  5513.      there is no other icon that occupies this position on the
  5514.      Workbench.
  5515.  
  5516. Question:
  5517.      As soon as I want to modify anything, a requester appears which
  5518.      tells me that I need "write access" before I may change my
  5519.      addresses.
  5520.  
  5521. *Answer:*
  5522.      Switch off the network mode (see PrefsMisc). If you need the
  5523.      network mode, select `Write Access' in the `Settings' menu of the
  5524.      *DFA-Editor*.
  5525.  
  5526. Question:
  5527.      If I hit the `HELP' key, I get no online help at all -- nothing
  5528.      happens!
  5529.  
  5530. *Answer:*
  5531.      Make sure that the online help files (`DFAEditor.guide' and
  5532.      `DFAPrefs.guide') exist and the corresponding tooltypes of the
  5533.      *DFA-Editor* and the *DFA-Preferences* program are set correctly
  5534.      (cf. PrefsTooltypes).
  5535.  
  5536. Question:
  5537.      I appended an old *DFA* file to the current address database, but
  5538.      the appended addresses are not displayed within the address
  5539.      listview!
  5540.  
  5541. *Answer:*
  5542.      Make sure that you activated the correct group flags. It might be
  5543.      that the appended addresses don't have any group flags set. If
  5544.      this is the case, you will have to *deactivate* all group check
  5545.      boxes in the *DFA-Editor* main window to see these addresses.
  5546.  
  5547. Question:
  5548.      If I access my addresses via AREXX, *DFA* doesn't seem to find all
  5549.      addresses -- sometimes it even finds no addresses at all!
  5550.  
  5551. *Answer:*
  5552.      Please notice that the AREXX commands access only the addresses
  5553.      that correspond to the current group selection! To make sure that
  5554.      all addresses can be reached by AREXX, you should either select all
  5555.      group flags in the *DFA-Editor* main window or use the AREXX
  5556.      command `CHANGEGROUPS' accordingly.
  5557.  
  5558. Question:
  5559.      After I've entered a new address containing group flags that did
  5560.      *not* match the current group selection, it was nevertheless
  5561.      displayed in the *DFA-Editor*'s main window listview. Isn't this
  5562.      behaviour a bit inconsequent?
  5563.  
  5564. *Answer:*
  5565.      Yes, indeed. However, for many people it would be even more
  5566.      confusing, if the new address which they've just entered is not
  5567.      displayed.
  5568.  
  5569. Question:
  5570.      Just after I entered a new address, it was displayed in the
  5571.      *DFA-Editor*'s main window corretly. After I've resized the
  5572.      window, however, the address has disappeared!
  5573.  
  5574. *Answer:*
  5575.      This problem should be seen together with the previous question.
  5576.      After a new address is entered, it is shown in the listview, no
  5577.      matter if the group selection fits or not. As soon as the window
  5578.      is resized, however, the listview entries are reformatted and the
  5579.      group selection is noticed! This causes all entries to disappear
  5580.      that do not match the current group selection.
  5581.  
  5582. Question:
  5583.      Although I have set the modem preferences as it is needed, my modem
  5584.      does not dial any telephone numbers. The phone number of the
  5585.      address to dial is displayed within the dial window, but the modem
  5586.      does nothing that looks like dialing!
  5587.  
  5588. *Answer:*
  5589.      Under some circumstances your modem does not like the baud rate you
  5590.      set in the *System Preferences* (Serial). Decrease the baud rate
  5591.      (in the System Preferences!) until your modem dials correctly.
  5592.  
  5593. Thanks to...
  5594. ************
  5595.  
  5596. Many people helped me to make *DFA* what it is today. Therefore I would
  5597. like to thank...
  5598.  
  5599.    ... *my betatesters*
  5600.  
  5601.      Stefan Bauer, Daniel Egger, Sven Gmelin, Michael 'Ghandi' Herold,
  5602.      Michael 'Mick' Hohmann, Martin Huttenloher, Kai Iske, Axel Jusek,
  5603.      Peter Klassmann, Michael Liebl, Sven Lucas, Carsten Melberg, Peter
  5604.      Meyer, Alexander Reifinger, Christoph Schuster, Manfred Schwab,
  5605.      Bernd Stieler, Stefan Stuntz, Robert Wahnsiedler, Christian Werner.
  5606.  
  5607.    ... *my registration sites*
  5608.  
  5609.      Robert Blayzor, Katja und Paul Jewell, Andre Lackmann, Christoph
  5610.      Reichert, Mats-Olov Rustad, Etienne Schneider, Olivier Toebosch.
  5611.  
  5612.    ... *Martin 'XEN' Huttenloher*
  5613.  
  5614.      Painted the wonderful MagicWB icons (8 colors)
  5615.  
  5616.      If you like the icons coming with this distribution of *DFA*, take
  5617.      a look at the complete collection of MagicWB icons by Martin
  5618.      Huttenloher.
  5619.  
  5620.    ... *Kai Iske*
  5621.  
  5622.      My "oldest" beta tester. He already tested *DFA* before version
  5623.      1.0 has been published! For version 2.0 of *DFA* he supplied me a
  5624.      fast sort routine. The `RemindBirthday' utility is done by him as
  5625.      well.
  5626.  
  5627.    ... *Katja and Paul Jewell, Donald Dalley*
  5628.  
  5629.      For the proof reading of the english manual.
  5630.  
  5631.    ... *Etienne Schneider*
  5632.  
  5633.      For the french locale files and the translation of the
  5634.      documentation.
  5635.  
  5636.    ... *Stefan Stuntz*
  5637.  
  5638.      For many telephone chats and his understanding that *DFA* still
  5639.      doesn't support his `Magic User Interface' (`MUI').
  5640.  
  5641.    ... *all others,* that are not explicitly listed here and have sent
  5642.      me bug reports and/or suggestions for improving *DFA*
  5643.  
  5644. Thanks a lot to all *DFA* users to be so patient while waiting for
  5645. *DFA* V2.0 such a long time. I do really hope it is worth the time
  5646. you've waited for it!
  5647.  
  5648. History
  5649. *******
  5650.  
  5651.  
  5652.  
  5653.      ------------------------------------------------------------
  5654.      Version 2.60                            (26.10.95 14:12:51)
  5655.      ------------------------------------------------------------
  5656.      
  5657.           - dfa.library/About: Updated about logo and copyright notice.
  5658.             Cleaned up gui calculation for the about window.
  5659.      
  5660.           - Recompiled using SAS\C 6.56
  5661.      
  5662.           - DFAEditor/SaveAs: Enforcer hit and junk within the pattern
  5663.             string gadget. Fixed.
  5664.      
  5665.           - DFAEditor: Refreshing of the edit window (simple refresh
  5666.             window) did not work. Fixed.
  5667.      
  5668.           - DFAEditor: Loading a Preferences file with more panel list-
  5669.             view lines than the current setting have, crashed the
  5670.             progam. Fixed.
  5671.             (Report: T.W. Hansen)
  5672.      
  5673.           - DFAEditor: RSHIFT-<Return> did not pop up the EDIT window as
  5674.             it did in former versions, but worked as a "Quick Search"
  5675.             keystroke. This did NOT make sense, so I disabled "Quick
  5676.             Search" for all ASCII charakters 'smaller' than the '!'.
  5677.             (Request: Xen)
  5678.      
  5679.      
  5680.      ------------------------------------------------------------
  5681.      Version 2.50                            (31.07.95 15:33:34)
  5682.      ------------------------------------------------------------
  5683.      
  5684.           - DFAEditor/Full: Edit/Ok button shortcuts had been exchanged.
  5685.             Fixed.
  5686.      
  5687.           - DFAEditor: Changed getting of halfshine pen. If everything
  5688.             else (i.e. ReadPixel()) fails, the halfshine pen is set to
  5689.             pen #5.
  5690.      
  5691.           - DFA-Server: Changed the CHANGEGROUPS command syntax. Added
  5692.             the 'ALL' parameter.
  5693.      
  5694.           - dfa.library: Fixed a bug in internal list functions that
  5695.             made the DFA->JumpTo function produce enfrocer hits.
  5696.      
  5697.           - DFAPrefs: After changing the screen prefs, DFAEditor and/or
  5698.             DFAPrefs are (re)opened on the new screen(s) at once.
  5699.             (Suggestion: D. Egger)
  5700.      
  5701.           - DFA-Editor: When you cancelled the input of a _new_ address,
  5702.             left the DFAEditor and reentered if (e.g. Hotkey), the
  5703.             program crashed during the reformatting of the listview.
  5704.             Fixed.
  5705.      
  5706.           - DFA-Prefs: Optimized window refreshing and made all windows
  5707.             simple refresh. Should be faster and less memory hungry now.
  5708.      
  5709.           - DFA-Editor: Optimized window refreshing and made all but the
  5710.             main window simple refresh windows. Should be faster and less memory
  5711.             hungry now.
  5712.      
  5713.           - DFA.library: Fixed a bug in readprefs(). Took me about 8h to
  5714.             track this one down! :-(
  5715.      
  5716.           - DFA-Server: Fixed several bugs regarding AppIcon/AppMenu.
  5717.      
  5718.           - DFAEditor: If you try to run the preferences program via the
  5719.             corresponding menu item and the prefs program is already
  5720.             running, it pops to front. Should have worked like this all
  5721.             the time before, but never did:-)
  5722.      
  5723.           - DFAEditor/Main: Hopefully fixed a bug, which could (!)
  5724.             appear, if you resized the main window severly times and
  5725.             clicked around like crazy;-) Made NewSize/SizeVerify
  5726.             messages "safer".
  5727.             (Report: Mick)
  5728.      
  5729.           - DFAEditor/(Un)Set Groups: New window layout. Instead of
  5730.             16 checkbox gadgets there are 8 cycle gadgets now. The
  5731.             result is the same as before, but I think it's better to use
  5732.             now and looks even nicer.
  5733.      
  5734.           - DFA.library: All DFA preferences files get a 'magic' now
  5735.             that prevents DFA from loading other than the correct
  5736.             DFA prefs files.
  5737.      
  5738.           - DFAPrefs/Misc: The AppIcon position is now updated as soon
  5739.             as you change its x and/or y position.
  5740.      
  5741.           - DFAPrefs: Several shortcuts did not work properly or were
  5742.             used twice. Fixed.
  5743.             (Report: A. Stieler)
  5744.      
  5745.           - DFAEditor: Added pattern field to 'Save as...' file
  5746.             requester.
  5747.             (Request: Mick)
  5748.      
  5749.           - DFA.library/global: In connection with the 'ADDRESSFILE'
  5750.             tooltype, an error requester appeared, telling you that
  5751.             the address file default.dfa could not be opened.
  5752.             Fixed.
  5753.      
  5754.           - DFAEditor/Main: Optimized refreshing after the user resized
  5755.             the main window. The window border wil now longer be
  5756.             overwritten, when the window is made smaller!
  5757.      
  5758.           - DFA.library/CustomScreens: Fixed the CustomScreen/OS2.x
  5759.             bug! Gave OS3.x Byte values to a OS2.x function that
  5760.             understands values from 0 to 15 only.
  5761.      
  5762.           - DFAEditor/Main: After resizing the window, the gadget panel
  5763.             was completely ENABLED, even if no entry of the listview had
  5764.             been selected at all!
  5765.             (Report: Mario Cattaneo)
  5766.      
  5767.           - DFAEditor/Full: After you have moved around within the
  5768.             address list and left the full window, the current position
  5769.             was NOT updated. Fixed.
  5770.             (Report: Mick)
  5771.      
  5772.           - DFAPrefs/Misc: 'Show AppMenu' text was too long. Shortened.
  5773.             (Report: Mick)
  5774.      
  5775.           - Network mode: Fixed several 'security holes', e.g.
  5776.             Full->Edit was always possible, even if the user did not
  5777.             have the write lock to the address file!
  5778.             (Report: Mick)
  5779.      
  5780.           - DFAEditor/Save: Auto-Write lock enabled.
  5781.             (Request: Mick)
  5782.      
  5783.           - DFAPrefs/Fonts: New button 'Same as Editor' copies the font
  5784.             settings from the DFAEditor to the DFAPrefs fields.
  5785.             (Suggestion: Mick)
  5786.      
  5787.           - DFA.library/About: The Update/Register button has been too
  5788.             small for the text.
  5789.             (Report: Mick)
  5790.      
  5791.           - DFAEditor/Main: Added menus for the displaysort (see below).
  5792.             This will sort the listview display by the menu item you
  5793.             select (Salutation, Name, ...). The internally stored data,
  5794.             however, are _not_ sorted. This has to be done by the usual
  5795.             sort function.
  5796.             Please notice: If you've used the display sort, The
  5797.             'quick search' (RSHIFT <letter>) function will _not_
  5798.             work on these resorted items.
  5799.             (Request: Mick)
  5800.      
  5801.           - DFA.library/Display-Sort: Implemented display sort routine.
  5802.             This will sort the _display_ of e.g. the DFA-Editor
  5803.             temporarily! I.e. the real order of the addresses will NOT
  5804.             be touched.
  5805.             (Request: Mick)
  5806.      
  5807.           - DFA.library/Sort(): Sped up sort function! Actually, the
  5808.             sort kept the same, but the list handling around the sort
  5809.             was highly optimized. Just try it!
  5810.      
  5811.           - DFAEditor: If you load an address file, the filename is
  5812.             updated within the window title now.
  5813.             (Report: B. Stieler)
  5814.      
  5815.           - DFAPrefs/Arexx: File requesters for loading arexx scripts
  5816.             now have a pattern string (will be saved with the prefs)
  5817.      
  5818.           - dfa.library/network: If one tries to get write access and a
  5819.             lockfile exists, which contains this user's and host's name,
  5820.             this lockfile will be deleted and the write access will
  5821.             succeed.
  5822.             (Suggestion: Mick)
  5823.      
  5824.           - DFAEditor/Load: Enabled Pattern-String in file requester.
  5825.             This pattern will be remembered and saved with the
  5826.             preferences.
  5827.             (Request: MickH)
  5828.      
  5829.           - DFAEditor/Full: Layout rewritten from scratch. Actually, it
  5830.             looks as it did before, but internally a lot was changed:-)
  5831.             As a consequence of this redesign the listview of this
  5832.             window will allways be sized as high that all address
  5833.             fields fit into it.
  5834.      
  5835.           - DFAPrefs/Arexx: Mixed up some gadtools tags -> underscore
  5836.             was not displayed correctly.
  5837.             (Report: Daniel Egger, Mick, ...)
  5838.      
  5839.           - DFAEditor: Auto write access mode changed. The network
  5840.             status window does no longer pup up while getting and
  5841.             freeing the write lock.
  5842.      
  5843.           - DFA library: Changed internal lock file format. Fields are
  5844.             seperated by a newline charakter now.
  5845.      
  5846.           - DFA library: DFA no longer reports an error, if there is no
  5847.             file name given in the DFAPrefs/Paths for the address file.
  5848.      
  5849.           - DFA (Server): ADDRESSFILE did not work properly. Fixed.
  5850.      
  5851.           - DFA-Library: Changed lock file naming. Now DFA tries first
  5852.             to append the 'lok' extension. If the filename is too long,
  5853.             it cuts as many charakters as needed from the original
  5854.             filename and appends the extension afterwards.
  5855.      
  5856.           - DFAEditor: When moving through the addresses using the
  5857.             cursor keys, the SELECTED and GROUPS flags where
  5858.             (automatically;-)) set wrong! Fixed.
  5859.      
  5860.           - DFAPrefs/Arexx: Underscores for gadget shortcuts
  5861.             are set correctly now.
  5862.      
  5863.           - DFA(Server): Frees write lock, if signalled by another
  5864.             DFA application.
  5865.      
  5866.           - DFAEditor: Frees write lock, if signalled by another
  5867.             DFA application.
  5868.      
  5869.           - DFAPrefs: Server is signalled, if network mode is
  5870.             disabled.
  5871.      
  5872.           - DFAPrefs: When you disable the network mode, the DFAEditor
  5873.             is signalled to free the write access.
  5874.      
  5875.           - DFAEditor: Finished new "auto write access" feature. There
  5876.             may be still some parts, which I've not updated, however.
  5877.      
  5878.           - DFAEditor: (Network mode) When you changed something and
  5879.             tried to leave the editor, you got the message to get write
  5880.             access first, you couldn't decide just to leave the editor
  5881.             without saving anything! Now, this is possible! ;-)
  5882.             (Request: Mick)
  5883.      
  5884.           - DFA-Editor: Started to implement auto locking for the
  5885.             network mode. Got it to work on a first, simple basis.
  5886.             Really hope, I can finish it, BEFORE I go to Spain...;-=)
  5887.      
  5888.           - DFA Library: File locking mechanism changed! It should be
  5889.             possible now, to use even NFS partitions to store the
  5890.             DFA databases.
  5891.             (Request: Mick)
  5892.      
  5893.           - DFAEditor/Edit: Movement from within the Edit window
  5894.             causes a reorganization of this and all related functions.
  5895.             "Some" work. Needs real testing as well!
  5896.      
  5897.           - DFAEditor: Started to implement movement functions into
  5898.             the Edit window similar to the Full window. I don't plan to
  5899.             provide any gadgets, but want to implemnt this using
  5900.             keys "only".
  5901.             (Suggestion: Mick)
  5902.      
  5903.           - DFAPrefs/Panel list: Added Up/Down/Insert line buttons.
  5904.             Changed behaviour ov the clear line button: Now all lines
  5905.             below the cleared one are moved up by one.
  5906.             (Suggestion: Mick)
  5907.      
  5908.           - DFAPrefs/Address list: Added Left/Right/Insert col.
  5909.             buttons. Changed behaviour of the clear column button:
  5910.             Now all columns behind the cleared one are move to front
  5911.             by one.
  5912.             (Suggestion: Mick)
  5913.      
  5914.           - DFA(Server)/SETPREFS,GETPREFS: Added parameters to
  5915.             get/set the groupnames.
  5916.             (Suggestion: H. Hucke)
  5917.      
  5918.           - DFA-Editor/Edit window: Alternate hires layout added.
  5919.             (Suggestion: Mick)
  5920.      
  5921.           - DFA-Prefs/Misc window: Additional Checkbox: Hires Mode.
  5922.             This checkbox dis-/enables the hires mode. Hires mode means
  5923.             that the user has plenty of room on his screens and wants to
  5924.             use the alternate hires layout, if available.
  5925.             (Suggestion: Mick)
  5926.      
  5927.           - DFA-Editor: "New" - Groups are preset to the groups
  5928.             currently selected in the main window.
  5929.             (Suggestion: Mick)
  5930.      
  5931.           - DFA-Editor: The name of the address file is shown in the
  5932.             title bar of the main window now.
  5933.      
  5934.           - Recompiled with SAS/C v6.55.
  5935.      
  5936.           - DFA.library: Finished custom screen support. Dropped the
  5937.             plan to support OWN public screens, so all you get are
  5938.             non public custom screens.
  5939.      
  5940.           - DFA-Library: Gave set custom screen settings (DFAPrefs)
  5941.             its functionality. Some file tuning keeps to be done I
  5942.             fear...:-)
  5943.      
  5944.           - DFAPrefs: Changed the GetEntry image
  5945.      
  5946.           - DFAPrefs: Screen mode window implemented, still non
  5947.             functional:-)
  5948.      
  5949.           - DFA-Editor: Postprocess script did handle EDITTEMPLATE
  5950.             tempararily as well as the "usual" template script, which
  5951.             may be considered to be a but:-) Fixed.
  5952.             (Report: Mick)
  5953.      
  5954.           - dfa.library: Changed parameters of adr_appendlist().
  5955.             Now you may additionally give a filename:-)
  5956.      
  5957.           - DFA-Server: Changed Arexx commands:
  5958.             LOAD/APPEND/SAVEAS to work with the new freq
  5959.             function.
  5960.      
  5961.           - dfa.library: New function dfa_getfilename() provides a nice
  5962.             way to select files (a file requester:-) and does all the
  5963.             boring stuff needed for this.
  5964.      
  5965.           - DFA-Server: Implemented Arexx command SAVEPREFS.
  5966.      
  5967.           - DFAEditor: Improved Edit-Hook. Now it supports jumping
  5968.             wordwise using <CRTL> <CURSOR> <LEFT|RIGHT>.
  5969.      
  5970.           - DFA-Server: Arexx command: Search
  5971.             Added new parameter NOWILDCARDS/S.
  5972.      
  5973.           - DFA-Server: New Arexx commands: SETPREFS, SAVEPREFS
  5974.      
  5975.           - DFAEditor: Made postprocessing arexx script work:-)
  5976.      
  5977.           - dfa.library: Load/Save function now take care of the
  5978.             protection bits and the user and group ids.
  5979.             (Request: Michael "Ghandi" Herold)
  5980.      
  5981.           - dfa.library: Tracked down one really ugly bug:
  5982.             while reformatting the display list, SOMETIMES memory was
  5983.             freed that already had been freed before! Really strange,
  5984.             but anyway, It's gone now (took this chance to add an
  5985.             AllocVecPooled stub to the library code:-))
  5986.      
  5987.           - DFAPrefs: Save about 1.5K by locale handling optimization:-)
  5988.      
  5989.           - DFA-Server: New Arexx command: LOADPREFS.
  5990.             This command loads an alternate prefs file.
  5991.      
  5992.           - dfa.library: Added support for nonwildcard search
  5993.             (see 'DFAEditor' below).
  5994.      
  5995.           - DFAEditor: The search window now has an additional
  5996.             checkbox "Use WildCards". If it is selected, searching is
  5997.             performed with complete pattern matching (#? etc.).
  5998.             If it is UNselected, only a partial string search is done.
  5999.             Less powerful, but very FAST :-)
  6000.      
  6001.           - DFAEditor: Completely redesigned the search window, well
  6002.             actually it looks similar as before, but was rewritten from
  6003.             scratch nevertheless.
  6004.      
  6005.           - DFAEditor: New menu items: Load Prefs, Save Prefs as.
  6006.             Now it is possible to use multiple prefs files.
  6007.      
  6008.           - DFA.library: Adopted read/write-prefs according to the
  6009.             new fields (arexx scripts...)
  6010.      
  6011.           - DFAPrefs: Added PostProcess script, and checkbox
  6012.             to switch it on/off
  6013.      
  6014.           - DFAEditor: Post processing script for the New function. This
  6015.             may even be dis/enabled seperately via a menu item and may
  6016.             be used to postprocess a just entered address.
  6017.      
  6018.           - DFAPrefs: Code cleanup...saved a few bytes:-)
  6019.      
  6020.           - DFAEditor: Added support for postprocess script
  6021.             for new function: This Arexx script will be executed, as
  6022.             soon as the new address has been entered.
  6023.      
  6024.           - DFAPrefs: New menu items:
  6025.             Open, Save as, Set To Defaults, Last Saved, Restore
  6026.      
  6027.           - DFAEditor: 2 new menu items to check/uncheck all
  6028.             group flags
  6029.      
  6030.           - DFAEditor: Bug in Edit window fixed. Every time you hit OK,
  6031.             a new entry was inserted into the address listview, although
  6032.             this new entry didn't exist at all!
  6033.             (Report: Kai Iske)
  6034.      
  6035.           - DFAPrefs: Changed "Arexx  Commands" window.
  6036.             * Support for shift qualifier
  6037.             * Support for template arexx script
  6038.             * New "layout" :-)
  6039.      
  6040.           - DFAEditor: Added 10 "additional" function keys for
  6041.             arexx scripts, i.e. you may execute 10 more arexx scripts
  6042.             by hitting <SHIFT> additionally.
  6043.      
  6044.           - DFAEditor: Now it is possible, to change the Template
  6045.             "during" the "New" procedure. I.e. you may set
  6046.             an arexx script which is executed every time you
  6047.             use the "New" command.
  6048.      
  6049.           - DFAEditor: New-Window. Additional gadget
  6050.             to make it possible to enter another NEW address
  6051.             without closing the window and open it again.
  6052.      
  6053.           - New Arexx command: EDITTEMPLATE
  6054.             Like "Edit", just for the template
  6055.      
  6056.           - New Arexx command: GETTEMPLATE
  6057.             Returns the template "address".
  6058.      
  6059.           - New Menu: Arexx Commands. All Arexx commands are
  6060.             listed here, especially to remind the user on which
  6061.             function key he installed which arexx command
  6062.      
  6063.      
  6064.      ------------------------------------------------------------
  6065.      Version 2.25                            (21.01.95 00:30:45)
  6066.      ------------------------------------------------------------
  6067.      
  6068.           - QuickSearch function (<RSHIFT><letter>) now works
  6069.             locale sensitive (if locale is installed).
  6070.      
  6071.           - New mapping routine for the DFAEditor images implemented.
  6072.      
  6073.           - QuickSearch function implemented. As soon as you hit RSHIFT-<letter>,
  6074.             in the DFAEditor main window, the first entry beginning with <letter>
  6075.             is selected.
  6076.             (Suggestion: Mick)
  6077.      
  6078.           - Arexx functions 'NEXT' and 'PREV' did not return an
  6079.             Arexx error code (RC != 0) when no next address was
  6080.             available. This has been a consequence of the enforcer
  6081.             hit removement and is fixed now!
  6082.      
  6083.           - Fixed several enforcer hits that came up, if you tried
  6084.             to move within an EMPTY address list using the Arexx
  6085.             commands 'first', 'last', 'next', 'prev', 'nextsel',
  6086.             'prevsel'.
  6087.      
  6088.      
  6089.      ------------------------------------------------------------
  6090.      Version 2.24                            (27.10.94 15:59:08)
  6091.      ------------------------------------------------------------
  6092.      
  6093.           - If you tried to delete the FIRST address in the address
  6094.             list, DFA crashed. Fixed.
  6095.      
  6096.      
  6097.      ------------------------------------------------------------
  6098.      Version 2.23                            (26.10.94 00:17:11)
  6099.      ------------------------------------------------------------
  6100.      
  6101.           - The 'ADDRESSFILE' tooltype and cli parameter respectively
  6102.             made some "problems", as it caused some enforcer hits,
  6103.             especially when you gave a nonexisting filename.
  6104.             (Report: Markus Stipp)
  6105.      
  6106.      
  6107.      ------------------------------------------------------------
  6108.      Version 2.22                            (25.10.94 23:09:40)
  6109.      ------------------------------------------------------------
  6110.      
  6111.           - After the arexx commands 'gui output off' and
  6112.             'gui output on' the current entry was not updated, which
  6113.             could lead to confusion:-)
  6114.             (Report: Kai Iske)
  6115.      
  6116.      
  6117.      ------------------------------------------------------------
  6118.      Version 2.21                            (14.10.94 12:07:42)
  6119.      ------------------------------------------------------------
  6120.      
  6121.           - If you entered more than 120 chars into the Comment field,
  6122.             DFA crashed, as the internal string buffer was a bit too
  6123.             small. Fixed.
  6124.             (Report: D. Ekholm)
  6125.      
  6126.      
  6127.      -----------------------------------------------------------
  6128.      Version 2.2                             (07.10.94 21:48:28)
  6129.      -----------------------------------------------------------
  6130.      
  6131.           - DFAEditor: If you selected 'All' to select all visible
  6132.             addresses, all available addresses were counted.
  6133.             This could lead to confusion:-). Fixed.
  6134.             (Report: Xen)
  6135.      
  6136.           - Locale bug fixed: If locale.library was present but not the
  6137.             locale: assign, DFA crashed:-(
  6138.      
  6139.           - Last minute bug fixed: If the editor was used without
  6140.             the server, it could happen (well, the chance was quite
  6141.             big:-)) that the Prefs program wasn't found!
  6142.      
  6143.           - (Un)set groups window did not close after pushing one of the
  6144.             (action) buttons, but you had to hit the close icon or the cancel
  6145.             button. Fixed.
  6146.             (Report: Xen)
  6147.      
  6148.           - CheckBirthday program included. Thanks Kai!
  6149.             Even got a wonderful icon for it. Thanks Xen!
  6150.      
  6151.           - DFAEditor/Print: A small window poped up, containing the
  6152.             printer name. I had forgotten to remove this 'puts()' call
  6153.             after a debugging session. Fixed.
  6154.             (Report: K.Kilper, M.Herold, etc.)
  6155.      
  6156.           - DFAEditor: Sometimes 'Addresses modified' text was
  6157.             not displayed - fixed.
  6158.             (Report: Michael Herold)
  6159.      
  6160.           - DFA-Editor: Status text display function deleted one
  6161.             pixel too much.
  6162.             (Report: Michael Herold)
  6163.      
  6164.           - Installer ist now available with german description texts
  6165.             as well. Notice: I still use the unlocalized installer, but
  6166.             have translated all custom description and help texts.
  6167.      
  6168.           - (Re)implemented "own" text gadget for the messages
  6169.             in the DFAEditor. This should remove any problems with
  6170.             OS < 3.x and several "special" fonts.
  6171.      
  6172.           - *** HD - Problem ***
  6173.             Some work lost ;-(
  6174.      
  6175.           - Search-Next after changing groups crashed.
  6176.             Fixed.
  6177.             (Report: Kai Iske)
  6178.      
  6179.           - If you've used a menu shortcut while the listview was
  6180.             reformatted (during the DFAEditor startup) and this caused
  6181.             a window to open, the main window poped in front as soon
  6182.             as the reformatting was finished. Fixed.
  6183.             (Report: Xen)
  6184.      
  6185.           - Cleaned up adr_fileio.h. Format strings no longer needed!
  6186.      
  6187.           - Changed the default address file name from
  6188.             s:adr.file to DFA:Addressfiles/default.dfa.
  6189.             This was done to give the DFA:AddressFiles drawer
  6190.             more sense. Up to now it has been an empty drawer;-))
  6191.      
  6192.           - Improved the information-i look. Up to now the
  6193.             lower serive has been overwritten by the frame.
  6194.             (Report: Xen)
  6195.      
  6196.           - Switched back to Smartrefresh...some tests showed that
  6197.             simple refresh leeds to problems at least while the main
  6198.             window input loop is "locked" (e.g. edit window active) or a
  6199.             bit "slow" (other activities).
  6200.      
  6201.           - Removed a bug that appeared after the change to a simple
  6202.             refresh window: Readpixel "sometimes" returned an error
  6203.             code (-1), but this code was used as a pen number ;-( .
  6204.      
  6205.           - Arexx-Port: IMPORTANT CHANGE
  6206.             Up to now I implemented the /T switch as described in
  6207.             the RKMs (3rd revision), i.e. giving the parameter just
  6208.             toggled the current stage. This was, however not 100%
  6209.             correct as newer information tells.
  6210.             Now, the /T switch works as it should have all the time
  6211.             before. Giving "ON" or "YES" means toggle switch on, "OFF" or
  6212.             "NO" means switch it off.
  6213.             I do really hope that this change will not lead to any
  6214.             troubles... ;-)
  6215.             (Report: Magnus Holmgren)
  6216.      
  6217.           - Arexx-Port: New command: GUI input/T output/T
  6218.             Enables/disables DFAEditor user input and DFAEditor
  6219.             "output", i.e. listview updating etc.
  6220.             (Request: Kai Iske)
  6221.      
  6222.           - DFAEditor main window has been an smart refresh window,
  6223.             which made the display "a bit slow" on 256 color screens.
  6224.             Now it's a simple refresh window with "custom" refresh
  6225.             handling.
  6226.             (Request: Kai Iske)
  6227.      
  6228.           - Search function: Looked up some wrong fields. Fixed.
  6229.             (Report: Henning Hucke)
  6230.      
  6231.           - "Improved" the about window, i.e. made it more "fool proof"
  6232.             against enforcer hits and "too" long strings.
  6233.             Do really hope it works in _every_ case;-)
  6234.             (Report: Kai Iske, Xen)
  6235.      
  6236.           - Implemeted visual feedback for all button gadgets in
  6237.             DFAEditor and DFAPrefs.
  6238.             Has been some work and needs some more code, but I think,
  6239.             it's worth the price;-))
  6240.      
  6241.           - Added some more messages for the DFA-Editor message
  6242.             gadget. Some fine tunig of the user interface for the
  6243.             "Search" and "Copy to Clip" functions.
  6244.      
  6245.           - Another speedup for the reformatting of the
  6246.             main address listview. Optimized puddle size for the main
  6247.             address list and the display list. Especially the display
  6248.             list puddle size was a bit too small.;-)
  6249.      
  6250.           - Enlarged buffer sizes for the string gadgets in
  6251.             DFAEditor/EditWindow. This is the last part in DFA where
  6252.             fixed sized buffers are needed, as Gadtools must know
  6253.             about the string gadget size.
  6254.      
  6255.           - Cleaned up some parts of code in:
  6256.             * DFAEditor/adr_showdial.c
  6257.             * reslib/adr_list.c
  6258.             * include/buffers.h
  6259.      
  6260.           - Enhancement: Sped up address file loading by some
  6261.             percent;-))
  6262.             (Request: Xen)
  6263.      
  6264.           - Changed locale handling! Up to now, ALL (english) default
  6265.             strings have been included into the dfa.library! This made
  6266.             not much sense, of course. Now,  the default locale strings
  6267.             are located where they are needed: In the different parts
  6268.             of DFA;-) (Editor/Server/Prefs)
  6269.      
  6270.           - Added clipboard support. Up to now there is only the
  6271.             possibility given to COPY the COMPLETE current address
  6272.             to the clipboard (UNIT 0). This can be enhanced, of course,
  6273.             either by configuration the fields to copy or by setting the
  6274.             clipboard unit, etc.
  6275.             Only NON-Zero fields are copied to the clipboard.
  6276.      
  6277.           - Some minor important window positions were not saved.
  6278.             Fixed.
  6279.      
  6280.           - (Un)set groups: It is possible now to change the addresses'
  6281.             group flags comfortably out of the DFAEditor main window.
  6282.             A window pops up that lets you set / unset the group flags
  6283.             of the active/all marked/all addresses.
  6284.             (Request: Michael 'Mick' Hohmann)
  6285.      
  6286.      
  6287.      -----------------------------------------------------------
  6288.      Version 2.1                             (12.05.94 18:12:28)
  6289.      -----------------------------------------------------------
  6290.      
  6291.           - Panel listview has had a "selected" text field. Removed.
  6292.      
  6293.           - Redesigned About window to display the DFA logo and the SASG
  6294.             logo as well. More work than I'd expected:-)
  6295.      
  6296.           - DFAEditor/Full: Description texts have been in english.
  6297.             Localization works now.
  6298.             (Report: Marcel Hofstetter)
  6299.      
  6300.           - DFAPrefs: Set RMBTRAP flag in all windows (exception: main
  6301.             window).
  6302.             (Suggestion: Marcel Hofstetter)
  6303.      
  6304.           - Added 'Windows' like gadget panel. Removed toolbox
  6305.             stuff.
  6306.      
  6307.           - Changed the Edithook for all windows of DFAPrefs that contain
  6308.             ONE string/integer gadget only. Up to now it has not been
  6309.             possible to leave such a gadget by hitting RETURN.
  6310.      
  6311.      
  6312.      -----------------------------------------------------------
  6313.      Version 2.0                             (21.04.94 00:07:57)
  6314.      -----------------------------------------------------------
  6315.      
  6316.             --- Initial release ---
  6317.  
  6318. Index
  6319. *****
  6320.  
  6321.  
  6322.  
  6323.  ADDRESSFILE                            ServerTooltypes
  6324.  ADDRESSFILE                            ServerCLIParams
  6325.  CX_POPKEY                              ServerTooltypes
  6326.  CX_POPKEY                              ServerCLIParams
  6327.  CX_POPUP                               ServerCLIParams
  6328.  CX_POPUP                               ServerTooltypes
  6329.  CX_PRIORITY                            ServerCLIParams
  6330.  CX_PRIORITY                            ServerTooltypes
  6331.  DFAEDITOR                              ServerCLIParams
  6332.  DFAEDITOR                              ServerTooltypes
  6333.  DFAPREFS                               EditorCLIParams
  6334.  DFAPREFS                               EditorTooltypes
  6335.  DONOTWAIT                              ServerTooltypes
  6336.  GUIDEFILE                              PrefsTooltypes
  6337.  GUIDEFILE                              EditorCLIParams
  6338.  GUIDEFILE                              EditorTooltypes
  6339.  GUIDEFILE                              PrefsCLIParams
  6340.  PORTNAME                               ServerCLIParams
  6341.  PORTNAME                               ServerTooltypes
  6342.  PUBSCREEN                              EditorTooltypes
  6343.  PUBSCREEN                              EditorCLIParams
  6344.  PUBSCREEN                              PrefsTooltypes
  6345.  PUBSCREEN                              PrefsCLIParams
  6346.  UPPERPUBSCREEN                         EditorTooltypes
  6347.  UPPERPUBSCREEN                         EditorCLIParams
  6348.  UPPERPUBSCREEN                         PrefsTooltypes
  6349.  UPPERPUBSCREEN                         PrefsCLIParams
  6350.  AREXX SCRIPTS                          Installation
  6351.  AREXX documentation                    ArexxBasics
  6352.  AREXX error codes                      ArexxErrorCodes
  6353.  AREXX port name                        ArexxBasics
  6354.  AREXX scripts                          Installation
  6355.  AREXX scripts                          Installation
  6356.  About                                  EditorMenuAbout
  6357.  About                                  PrefsMainMenuAbout
  6358.  About                                  EditorMenuAbout
  6359.  Address                                Addresses
  6360.  Address file                           PrefsPaths
  6361.  address file format                    EditorMenuOpen
  6362.  address files                          ArexxBasics
  6363.  Address list                           EditorMainWindow
  6364.  Address listview                       EditorMainWindow
  6365.  Address Listview                       PrefsAList
  6366.  Address of the author                  PrefsMainMenuAbout
  6367.  Address of the author                  EditorMenuAbout
  6368.  Addresses                              EditorMenuInfo
  6369.  Adress of the author                   MyAddress
  6370.  All                                    EditorSearch
  6371.  AMIGA pattern                          EditorSearch
  6372.  Append                                 EditorMenuAppend
  6373.  Append                                 EditorMenuAppend
  6374.  AppIcon                                EditorMainWindow
  6375.  AppIcon                                EditorMenuQuit
  6376.  Application Icon                       EditorMenuQuit
  6377.  Application icon                       EditorMainWindow
  6378.  Application Icon                       PrefsAppIcon
  6379.  Application Icon Position              PrefsAppIcon
  6380.  Application Menu                       PrefsAppMenu
  6381.  Application Window                     EditorMainWindow
  6382.  Application-Icon                       AppIcon
  6383.  Arexx                                  Arexx
  6384.  Arexx Basics                           ArexxBasics
  6385.  Arexx commands                         ArexxCommands
  6386.  Arexx Commands                         EditorMenuArexxCommands
  6387.  Arexx Commands                         EditorMenuArexxCommands
  6388.  Arexx Port                             EditorMenuInfo
  6389.  Arexx return value                     ArexxReturnAddress
  6390.  Arexx Scripts                          PrefsArexxCmds
  6391.  Arexx Scripts                          EditorMainWindow
  6392.  ASCII editor                           PrefsPaths
  6393.  ASCII Viewer                           PrefsPaths
  6394.  Author's address                       PrefsMainMenuAbout
  6395.  Auto Save                              PrefsAutoSave
  6396.  backup                                 ArexxBasics
  6397.  Bank address                           BelgiumRegSite
  6398.  Bank address                           EnglishRegSite
  6399.  Bank address                           MyAddress
  6400.  Bank address                           GermanRegSite
  6401.  bank transfer                          EnglishRegSite
  6402.  bank transfer                          MyAddress
  6403.  bank transfer                          BelgiumRegSite
  6404.  bank transfer                          GermanRegSite
  6405.  Baud                                   PrefsModem
  6406.  Bug Reports                            Bugreports
  6407.  Bug Reports                            Bugreports
  6408.  Button gadget                          UsingDFA
  6409.  Calling                                EditorMenuDial
  6410.  Calling                                PrefsModem
  6411.  Calling                                EditorTools
  6412.  Cancel (Edit)                          EditorEdit
  6413.  Cancel (Print)                         EditorPrint
  6414.  Cancel (Search)                        EditorSearch
  6415.  Change Templates                       EditorMenuEditTemplate
  6416.  Check Box                              UsingDFA
  6417.  CheckBirthday                          CheckBirthday
  6418.  Clear Column                           PrefsAList
  6419.  Clear line                             PrefsPList
  6420.  Clear mark                             EditorMainWindow
  6421.  Clear sort criteria                    PrefsSort
  6422.  CLI Parameter of the *DFA-Editor* programEditorCLIParams
  6423.  CLI Parameters of the *DFA-Server*     ServerCLIParams
  6424.  CLI-Parameter des *DFA-Preferences*-ProgrammsPrefsCLIParams
  6425.  Column                                 PrefsAList
  6426.  Commodity                              Commodity
  6427.  Copy to Clipboard                      EditorMenuCopyToClip
  6428.  Copy to Clipboard                      EditorMenuCopyToClip
  6429.  Copyright                              PrefsMainMenuAbout
  6430.  Copyright                              EditorMenuAbout
  6431.  Copyright                              Copyright
  6432.  Custom Screen (*DFA-Editor*)           PrefsScreenEditor
  6433.  Custom Screen *DFA-Preferences Program*PrefsScreenPrefs
  6434.  Custom Screens                         PrefsScreen
  6435.  Cycle Gadget                           UsingDFA
  6436.  default settings                       Quick Start
  6437.  Device unit                            PrefsModem
  6438.  Dial                                   EditorDial
  6439.  Dial                                   EditorTools
  6440.  Dial                                   EditorMenuDial
  6441.  Dialing                                PrefsModem
  6442.  Display Sort                           EditorMenuDSort
  6443.  Documentation for using AREXX          ArexxBasics
  6444.  Edit                                   EditorTools
  6445.  Edit                                   EditorFull
  6446.  Edit                                   EditorEdit
  6447.  Edit                                   EditorEdit
  6448.  Edit                                   EditorMenuEdit
  6449.  Edit                                   EditorMenuEdit
  6450.  Edit Template                          EditorMenuEditTemplate
  6451.  EMail address of the author            EditorMenuAbout
  6452.  Error codes of AREXX                   ArexxErrorCodes
  6453.  Exchange program                       Commodity
  6454.  External                               EditorEdit
  6455.  External file                          EditorEdit
  6456.  External files                         PrefsPaths
  6457.  Features                               Features
  6458.  Fields                                 PrefsPList
  6459.  Fields                                 PrefsSort
  6460.  Fields                                 PrefsAList
  6461.  Fields to search                       EditorSearch
  6462.  File editor                            PrefsPaths
  6463.  file format                            EditorMenuOpen
  6464.  File Viewer                            PrefsPaths
  6465.  Filename                               ArexxBasics
  6466.  Find                                   EditorMenuSearch
  6467.  find                                   EditorTools
  6468.  First                                  EditorFull
  6469.  Fonts                                  PrefsFonts
  6470.  Format of the Address Field            ArexxReturnAddress
  6471.  format of the address file             EditorMenuOpen
  6472.  Formfeed                               EditorPrint
  6473.  Free                                   PrefsAList
  6474.  Full                                   EditorFull
  6475.  Full                                   EditorMenuFull
  6476.  Full                                   EditorMenuFull
  6477.  Full                                   EditorTools
  6478.  Generate Icon                          PrefsGenIcon
  6479.  Giving a filename                      ArexxBasics
  6480.  Group handling                         PrefsGroups
  6481.  Groups                                 PrefsGroups
  6482.  Groups                                 PrefsGroups
  6483.  Hangup String                          PrefsModem
  6484.  Hardware                               MinConfig
  6485.  Hayes compatible                       PrefsModem
  6486.  Hints and Tips                         Tips
  6487.  Hires Mode                             PrefsHiresMode
  6488.  History                                History
  6489.  hotkey                                 ServerTooltypes
  6490.  Hotkey                                 EditorMenuQuit
  6491.  Hotkey                                 EditorMainWindow
  6492.  hotkey                                 Commodity
  6493.  Ignore case                            EditorSearch
  6494.  Important addresses                    Addresses
  6495.  Info                                   EditorMenuInfo
  6496.  Information                            EditorMenuInfo
  6497.  Init String                            PrefsModem
  6498.  Insert Column                          PrefsAList
  6499.  Insert line                            PrefsPList
  6500.  Installation                           Installation
  6501.  Installer                              Installation
  6502.  Installieren                           Installation
  6503.  interface card                         PrefsModem
  6504.  interface card                         PrefsModem
  6505.  Internal                               Internal
  6506.  keyboard usage                         UsingDFA
  6507.  Kill                                   EditorMenuKill
  6508.  Kill                                   EditorMenuKill
  6509.  Kill                                   EditorTools
  6510.  language                               Installation
  6511.  language                               Top
  6512.  Last                                   EditorFull
  6513.  Last Saved                             PrefsMainMenuLastSaved
  6514.  Legal stuff                            Legal
  6515.  Licence                                Licence
  6516.  Lines                                  PrefsPList
  6517.  Listview                               UsingDFA
  6518.  Listview (main window)                 EditorMainWindow
  6519.  Load                                   EditorMenuOpen
  6520.  Load Preferences                       EditorMenuLoadPrefs
  6521.  Load Preferences                       EditorMenuLoadPrefs
  6522.  Load Settings                          EditorMenuLoadPrefs
  6523.  Locale                                 IntLocaleSupport
  6524.  locale support                         Installation
  6525.  Mark all                               EditorMainWindow
  6526.  Mark by name                           EditorMainWindow
  6527.  Marking addresses                      EditorMainWindow
  6528.  Memory Condition                       EditorMenuInfo
  6529.  Menus                                  EditorMenus
  6530.  Miscelleneous                          PrefsMisc
  6531.  Modem                                  PrefsModem
  6532.  Move down                              PrefsPList
  6533.  Move left                              PrefsAList
  6534.  Move right                             PrefsAList
  6535.  Move up                                PrefsPList
  6536.  Native languages                       IntLocaleSupport
  6537.  Needed Configuration                   MinConfig
  6538.  network mode                           EditorMenuWriteAccess
  6539.  Network mode                           PrefsNetworking
  6540.  Networking                             PrefsNetworking
  6541.  New                                    EditorTools
  6542.  New                                    EditorMenuNew
  6543.  New                                    EditorMenuNew
  6544.  New                                    EditorNew
  6545.  New                                    EditorNew
  6546.  New address file                       EditorMenuNewFile
  6547.  New file                               EditorMenuNewFile
  6548.  New since version 1.2x                 ArexxImportant
  6549.  Next                                   EditorFull
  6550.  Next New                               EditorNew
  6551.  Next Sel.                              EditorFull
  6552.  None                                   EditorSearch
  6553.  Ok (Edit)                              EditorEdit
  6554.  Ok (Full)                              EditorFull
  6555.  Online Help                            UsingDFA
  6556.  Open                                   EditorMenuOpen
  6557.  Open Preferences                       PrefsMainMenuOpen
  6558.  order of the address fields            ArexxImportant
  6559.  OwnDevUnit                             PrefsModem
  6560.  Panel Listview                         EditorMainWindow
  6561.  Panel Listview                         PrefsPList
  6562.  Paths and Filenames                    PrefsPaths
  6563.  Pattern                                EditorSearch
  6564.  Pattern                                EditorSearch
  6565.  Phone                                  EditorMenuDial
  6566.  Phone                                  PrefsModem
  6567.  Phone                                  EditorTools
  6568.  Phone                                  EditorDial
  6569.  Port name for AREXX                    ArexxBasics
  6570.  Position of the Application Icon       PrefsAppIcon
  6571.  Postprocess Script                     EditorNew
  6572.  Predial String                         PrefsModem
  6573.  Preferences                            EditorMenuPreferences
  6574.  Preferences                            EditorMenuPreferences
  6575.  Presets                                EditorMenuEditTemplate
  6576.  Prev.                                  EditorFull
  6577.  Prev. Sel.                             EditorFull
  6578.  Print                                  EditorTools
  6579.  Print                                  EditorPrint
  6580.  Print                                  EditorPrint
  6581.  Print                                  EditorMenuPrint
  6582.  Print                                  EditorPrint
  6583.  Print                                  EditorPrint
  6584.  Print                                  EditorMenuPrint
  6585.  Print form                             EditorPrint
  6586.  Print style                            EditorPrint
  6587.  Print to                               EditorPrint
  6588.  program language                       Top
  6589.  program texts                          Top
  6590.  Public Screen                          EditorTooltypes
  6591.  Public Screen                          PrefsTooltypes
  6592.  Quick Search                           EditorMainWindow
  6593.  Quick Search                           EditorMainWindow
  6594.  Quick Start                            Quick Start
  6595.  Quit                                   EditorMenuQuit
  6596.  Quit                                   EditorMenuQuit
  6597.  Quit (*DFA-Editor* main window)        EditorMainWindow
  6598.  Quit Preferences                       PrefsMainQuit
  6599.  Quit Preferences                       PrefsMainMenuQuit
  6600.  Radio button                           UsingDFA
  6601.  Receiving AREXX commands               ArexxBasics
  6602.  Redial delay                           PrefsModem
  6603.  Registration                           Registration
  6604.  Registration                           Registration
  6605.  Registration in Belgium                BelgiumRegSite
  6606.  Registration in England                EnglishRegSite
  6607.  Registration in France                 FrenchRegSite
  6608.  Registration in Germany                GermanRegSite
  6609.  Registration in Sweden                 NordicRegSite
  6610.  Registration in the USA                USARegSite
  6611.  Remove                                 EditorMenuRemove
  6612.  Remove                                 EditorMenuRemove
  6613.  Remove (*DFA-Editor* main window)      EditorMenuRemove
  6614.  Remove (*DFA-Editor* main window)      EditorMainWindow
  6615.  Remove DFA                             PrefsMainRemove
  6616.  Remove DFA                             PrefsMainMenuRemove
  6617.  Reset To Defaults                      PrefsMainMenuReset
  6618.  Restore                                PrefsMainMenuRestore
  6619.  Retries                                PrefsModem
  6620.  Retries                                PrefsNetworking
  6621.  Retry delay                            PrefsNetworking
  6622.  Return of address items                ArexxReturnAddress
  6623.  RXERR_APPENDFAILED                     ArexxErrorCodes
  6624.  RXERR_CRTEXTIO                         ArexxErrorCodes
  6625.  RXERR_CRTPORT                          ArexxErrorCodes
  6626.  RXERR_ENVCHANGED                       ArexxErrorCodes
  6627.  RXERR_MODIFIED                         ArexxErrorCodes
  6628.  RXERR_NOCURRENT                        ArexxErrorCodes
  6629.  RXERR_NODIR                            ArexxErrorCodes
  6630.  RXERR_NOEXTERNAL                       ArexxErrorCodes
  6631.  RXERR_NOFILE                           ArexxErrorCodes
  6632.  RXERR_NOFILENAME                       ArexxErrorCodes
  6633.  RXERR_NOFIRST                          ArexxErrorCodes
  6634.  RXERR_NOICONIFY                        ArexxErrorCodes
  6635.  RXERR_NOLAST                           ArexxErrorCodes
  6636.  RXERR_NOLOAD                           ArexxErrorCodes
  6637.  RXERR_NOMEM                            ArexxErrorCodes
  6638.  RXERR_NONETWORKAPPEND                  ArexxErrorCodes
  6639.  RXERR_NONETWORKCLEAR                   ArexxErrorCodes
  6640.  RXERR_NONETWORKEDIT                    ArexxErrorCodes
  6641.  RXERR_NONETWORKKILL                    ArexxErrorCodes
  6642.  RXERR_NONETWORKNEW                     ArexxErrorCodes
  6643.  RXERR_NONETWORKSAVE                    ArexxErrorCodes
  6644.  RXERR_NONETWORKSELECT                  ArexxErrorCodes
  6645.  RXERR_NONETWORKSORT                    ArexxErrorCodes
  6646.  RXERR_NONEXT                           ArexxErrorCodes
  6647.  RXERR_NONEXTSEL                        ArexxErrorCodes
  6648.  RXERR_NOPHONENUM                       ArexxErrorCodes
  6649.  RXERR_NOPREV                           ArexxErrorCodes
  6650.  RXERR_NOPREVSEL                        ArexxErrorCodes
  6651.  RXERR_NORELOAD                         ArexxErrorCodes
  6652.  RXERR_NOSAVE                           ArexxErrorCodes
  6653.  RXERR_NOSERIALDEV                      ArexxErrorCodes
  6654.  RXERR_NOTFOUND                         ArexxErrorCodes
  6655.  RXERR_NOWRITELOCK                      ArexxErrorCodes
  6656.  RXERR_OPNPRFS                          ArexxErrorCodes
  6657.  RXERR_OPNPRT                           ArexxErrorCodes
  6658.  RXERR_SERBUSY                          ArexxErrorCodes
  6659.  RXERR_SERCONNECT                       ArexxErrorCodes
  6660.  RXERR_SERERROR                         ArexxErrorCodes
  6661.  RXERR_SERNOCARRIER                     ArexxErrorCodes
  6662.  RXERR_SERNODIALTONE                    ArexxErrorCodes
  6663.  RXERR_SEROK                            ArexxErrorCodes
  6664.  RXERR_SERRING                          ArexxErrorCodes
  6665.  RXERR_SERUNKNOWN                       ArexxErrorCodes
  6666.  RXERR_SERVOICE                         ArexxErrorCodes
  6667.  RXERR_SYNTAX                           ArexxErrorCodes
  6668.  RXERR_WRITEALL                         ArexxErrorCodes
  6669.  RXERR_WRITECURRENT                     ArexxErrorCodes
  6670.  RXERR_WRITESEL                         ArexxErrorCodes
  6671.  Save                                   EditorMenuSave
  6672.  Save                                   EditorMenuSave
  6673.  Save as default                        EditorMenuSaveasdefault
  6674.  Save as default                        EditorMenuSaveasdefault
  6675.  Save as...                             EditorMenuSaveas
  6676.  Save as...                             EditorMenuSaveas
  6677.  Save Preferences                       PrefsMainSave
  6678.  Save Preferences                       EditorMenuSavePrefs
  6679.  Save Preferences                       EditorMenuSavePrefs
  6680.  Save Preferences                       PrefsMainMenuSave
  6681.  Save Preferences as                    PrefsMainMenuSaveAs
  6682.  Save Preferences as                    EditorMenuSavePrefsAs
  6683.  Save Preferences as                    EditorMenuSavePrefsAs
  6684.  Save Settings as                       EditorMenuSavePrefsAs
  6685.  Schnell-Suche                          EditorMainWindow
  6686.  search                                 EditorTools
  6687.  Search                                 EditorMenuSearch
  6688.  Search                                 EditorTools
  6689.  Search                                 EditorMenuSearch
  6690.  Search                                 EditorSearch
  6691.  Search                                 EditorSearch
  6692.  search criteria                        EditorTools
  6693.  Search criteria                        EditorMenuSearch
  6694.  Search for                             EditorSearch
  6695.  Search Next                            EditorTools
  6696.  Search Next                            EditorMenuSearchNext
  6697.  Secret Mode                            PrefsSecretMode
  6698.  Select device                          PrefsModem
  6699.  Select Groups                          EditorMenuGroupSelection
  6700.  Select Groups                          EditorMenuGroupSelection
  6701.  Selection                              EditorMainWindow
  6702.  Selection                              EditorMainWindow
  6703.  Selection of Addresses                 EditorMainWindow
  6704.  Selection: All                         EditorMainWindow
  6705.  Selection: By name                     EditorMainWindow
  6706.  Selection: Clear                       EditorMainWindow
  6707.  Selection: Jump to                     EditorMainWindow
  6708.  Serial device                          PrefsModem
  6709.  serial interface                       PrefsModem
  6710.  serial interface                       PrefsModem
  6711.  Serial number                          EditorMenuAbout
  6712.  Serial number                          PrefsMainMenuAbout
  6713.  Serielles Gerät                       PrefsModem
  6714.  Set and Unset Groups                   EditorMenuSetGroups
  6715.  Set Groups                             EditorMenuSetGroups
  6716.  shared access                          EditorMenuWriteAccess
  6717.  shortcut                               UsingDFA
  6718.  Show Application Icon                  PrefsAppIcon
  6719.  Software                               MinConfig
  6720.  Sort                                   PrefsSort
  6721.  Sort                                   EditorMenuSort
  6722.  Sort                                   EditorTools
  6723.  Sorting                                PrefsSort
  6724.  Sorting of the Address Display         EditorMenuDSort
  6725.  String Gadget                          UsingDFA
  6726.  Suff. Dial String                      PrefsModem
  6727.  Syntax                                 ArexxBasics
  6728.  Template address                       EditorNew
  6729.  Template script                        EditorNew
  6730.  Templates                              EditorMenuEditTemplate
  6731.  Text Gadget                            UsingDFA
  6732.  Text Viewer                            PrefsPaths
  6733.  Thanks to...                           Thanks
  6734.  The CheckBirthday Program              CheckBirthday
  6735.  The concept of DFA                     Concept
  6736.  The DFA-Editor program                 DFAEditor
  6737.  The DFA-Preferences Main Window        PrefsMainWindow
  6738.  The DFA-Preferences Program            DFAPrefs
  6739.  The DFA-Server program                 DFAServer
  6740.  The Main Window                        EditorMainWindow
  6741.  The Menu Items of the *DFA-Editor*     EditorMenus
  6742.  Title                                  PrefsPList
  6743.  Title                                  PrefsGroups
  6744.  Tool Gadgets                           EditorTools
  6745.  Tool Gadgets                           EditorTools
  6746.  Tool Types of the *DFA-Preferences* programmsPrefsTooltypes
  6747.  Tooltypes                              ServerTooltypes
  6748.  Tooltypes                              ServerTooltypes
  6749.  Tooltypes for the *DFA-Editor*         EditorTooltypes
  6750.  Unset Groups                           EditorMenuSetGroups
  6751.  Updates                                Updates
  6752.  Usage of DFA                           UsingDFA
  6753.  Use                                    PrefsMainMenuUse
  6754.  Use Postprocess Script                 EditorMenuUsePostProcess
  6755.  Use Preferences                        PrefsMainUse
  6756.  Use Template Script                    EditorMenuUseTemplate
  6757.  Use Wildcards                          EditorSearch
  6758.  Used                                   PrefsAList
  6759.  Version number                         PrefsMainMenuAbout
  6760.  version number                         EditorMenuAbout
  6761.  Visible lines                          PrefsPList
  6762.  Warranty                               Warranty
  6763.  Weight                                 PrefsAList
  6764.  Write Access                           EditorMenuWriteAccess
  6765.  Write Access                           EditorMenuWriteAccess
  6766.  
  6767.